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Introduction 


NeXTSTEP™ Programming Interface Summary provides the syntax of all programming 
elements in the NeXTSTEP environment. It’s intended to be used as a quick reference 
companion to the NeXTSTEP General Reference; everything that’s described in the General 
Reference is summarized here. 

The organization of this manual parallels that of NeXTSTEP General Reference. It starts 
with the root class: the Object class that is at the root of the inheritance tree of NeXTSTEP 
classes. Each of the specialized kits has a chapter to itself, including Application Kit™, 
Database Kit™, Indexing Kit™, Mach Kit™, Netlnfo Kit™, Phone Kit™, and 3D Graphics Kit™. 
Three chapters deal with the programmatic interface to NeXT applications: Interface 
Builder™, Workspace Manager™, and Preferences. Three chapters treat topics that are not 
considered to be kits: sound, video, and MIDI. Five chapters are devoted to general 
facilities: the common classes and functions, Display PostScript®, the run-time system, 
distributed objects, and functions that invoke the Mach operating system. 

This book is part of a collection of manuals called the NeXTSTEP Developer’s Library. 


Syntax Notation 

In these summaries, bold and italic have the following significance: 

• Bold denotes a word or character that is to be taken literally (typed as it appears). 

• Italic denotes a placeholder for an element—typically an argument name—that 
you supply. 




Root Class 


Class 


Object 


Inherits From: Object is the root class 

Initializing the Class 
+ initialize 

Creating, Copying, and Freeing Instances 
+ alloc 

+ allocFromZone:(NXZone *)zone 

+ new 

-copy 

- copyFromZone:(NXZone *)zone 

- (NXZone *)zone 

- free 
+ free 


Implemented by subclasses to initialize the class 


Returns a new, uninitialized instance 

Returns a new, uninitialized instance allocated from zone 

Returns a new, initialized instance 

Returns an exact copy of the receiver 

Returns an exact copy of the receiver allocated from zone 

Returns a pointer to the zone where the receiver resides 

Deallocates the memory occupied by the receiver 

Returns nil (you can’t free a class) 


Class: Object 1-1 




Initializing a New Instance 


- init 


Initializes a new instance after it has been allocated 


Identifying Classes 

+ (const char *)name 
+ class 

- class 

+ superclass 

- superclass 

Identifying and Comparing Instances 

- (BOOL)isEquaI:a«C%'ect 

- (unsigned int)hash 
-self 

- (const char *)name 

- (void)printForDebugger:(NXStream *)stream 


Returns the name of the class 

Returns the receiver, a class object 

Returns the class object for the receiver’s class 

Returns the class object for the receiver’s superclass 

Returns the class object for the receiver’s superclass 


Returns whether the receiver and anObject are the same 
Returns an unsigned integer unique to the receiver 
Returns the receiver, an instance 
Implemented by subclasses to return the receiver’s name 
Writes information identifying the receiver to stream 


Testing Inheritance Relationships 

- (BOOL)isKindOf :aClassObject Returns whether the receiver inherits from aClassObject 

- (BOOL)isKindOfCIassNamed:(const char *)aClassName 

Returns whether the receiver inherits from aClassName 

- (BOOL)isMemberOf:aC/a«0Z?/ect Returns whether the receiver is an instance of aClassObject 

- (BOOL)isMemberOfClassNamed:(const char *)aClassName 

Returns whether the receiver is an instance of aClassName 


Testing Class Functionality 

- (BOOL)respondsTo:(SEL)tf 1 S , e/ecfor 

+ (BOOL)instancesRespondTo:(SEL)a 1 S’c/ccr<9r 

Testing for Protocol Conformance 

+ (BOOL)conformsTo:(Protocol *)aProtocol 

- (BOOL)conformsTo:(Protocol *)aProtocol 


Returns whether the receiver can respond to aSelector 
Returns whether instances can respond to aSelector 


Returns whether the receiver conforms to aProtocol 
Returns whether the receiver’s class conforms to aProtocol 
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Sending Messages Determined at Run Time 

- perform :(SEL)aSelector Sends an aSelector message to the receiver 

- perform:(SEL)aS<?/ecror witl v.anObject Sends an aSelector message with one argument 

- perform: (SELjaSelector Sends an aSelector message with two arguments 

with :anObject 
with '.anotherObject 

Forwarding Messages 

- forward:(SEL)oSWector :(marg_list)argFrame Implemented by subclasses to forward messages 

- performv:(SEL )aSelector :(marg_list)arg Frame Sends an aSelector message with argFrame arguments 

Obtaining Method Information 

- (IMP)methodFor:(SEL)fl 5 e/ector Locates the receiver’s implementation of aSelector 

+ (IMP)instanceMethodFor:(SEL)aSWector Locates the implementation of aSelector 

- (struct objc_method_description *)descriptionForMethod:(SEL)aSW<?c/or 

Retums information about the aSelector method 

+ (struct objc_method_description *)descriptionForInstanceMethod:(SEL)aSWector 

Retums information about the aSelector instance method 

Posing 

+ poseAs :aClassObject Substitutes the receiving class for aClassObject 

Enforcing Intentions 

- notlmplemented: (SEL)aSelector Indicates that aSelector isn’t fully implemented 

- subcIassResponsibility:(SEL)<2SWecf0r Generates an error if aSelector isn’t implemented 

Error Handling 

- doesNotRecognize: (SEL )aSelector 

- error: (const char *)aString, ... 

Dynamic Loading 

+ fmishLoading:(struct mach_header *)header Implemented by a newly loaded class or category 
+ startUnloading Implemented by a class or category about to be unloaded 


Generates an unrecognized-selector error message 
Generates a formatted error message using aString 


Class: Object 1-3 



Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 

- startArchiving:(NXTypedStream *)stream 

- awake 

- finishUnarchiving 

+ setVersion:(int)a Version 
+ (int)version 


Implemented by subclasses to read receiver from stream 
Implemented by subclasses to write the receiver to stream 
Implemented by subclasses to prepare for archiving 
Implemented by subclasses to reinitialize the receiver 
Implemented by subclasses to replace the receiver 
Sets the class version number to aVersion 
Returns the version of the class definition 
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Types and Constants 


Defined Types 

BOOL 

typedef char BOOL; 

Class 

typedef struct objc_class *Class; 

id 

typedef struct objc_object { 

Class isa; 

} *id; 

IMP 

typedef id (*IMP) (id, SEL,...); 

SEL 

typedef struct objc_selector *SEL; 

STR 

typedef char *STR; 


Types and Constants 



Symbolic Constants 


Boolean Constants 

YES 

NO 


Empty Objects 

nil 

Nil 


(BOOL)l 

(BOOL)O 


(id)0 

(Class)O 
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Application Kit 


Classes 


ActionCell 


Inherits From: Cell: Object 


Configuring an ActionCell 

- setEnabled: (BOOL)flag 

- setBezeled:(BOOL)/fag 

- setBordered:(BOOL)/7<2g 

- set Alignment: (int)mode 

- setFloatingPointFormat:(BOOL)tfutafam,ge 

left: (unsigned int )leftDigits 
right: (unsigned mX)rightDigits 

- setFonUfontObject 

- setIcon:(const char *)iconName 

Manipulating ActionCell Values 

- (double)double Value 

- (float)floatValue 


Sets whether the ActionCell reacts to mouse events 
Adds or removes the ActionCell’s bezel 
Adds or removes the ActionCell’s border 
Sets the ActionCell’s text alignment to mode 
Sets the ActionCell’s floating point format 

Sets the ActionCell’s Font to fontObject 
Sets the ActionCell’s icon to the NXImage named 
iconName 


Returns the ActionCell’s contents as a double 
Returns the ActionCell’s contents as a float 
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- (int)int Value 

- setStringValue:(const char *)aString 

- setStringValueNoCopy: (char *)aString 

shouldFree: (BOOL )flag 

- (const char *)stringValue 

Displaying 

- drawSelf: (const NXRect *)cellFrame 

in View ‘.controlView 

- controlView 

Target and Action 

- setAction^SELjaSe/ector 

- (SEL)action 

- setTarg et'.anObject 

- target 

Assigning a Tag 

- setTag:(int )anlnt 

- (int)tag 

Archiving 

- read:(NXTypedStream *)stream 

- write: (NXTypedStream *)stream 


Returns the ActionCell’s contents as an int 
Sets the ActionCell’s contents to a copy of aString 

Sets the ActionCell’s contents to a aString; will free the 
string when freed if flag is YES 

Returns the ActionCell’s contents as a string 


Draws the ActionCell in controlView 

Returns the View in which the ActionCell was most 
recently drawn (usually a Control) 


Sets the ActionCell’s action method to aSelector 
Returns the ActionCell’s action method 
Sets the ActionCell’s target object to anObject 
Returns the ActionCell’s target object 


Sets the ActionCell’s tag to anlnt 
Returns the ActionCell’s tag 


Reads the ActionCell from stream 
Writes the ActionCell to stream 


Application 


Inherits From: Responder: Object 

Initializing the Class Object 

+ initialize Registers defaults for the application 
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Creating and Freeing Instances 


+ new 
-free 


Returns a new Application object 
Deallocates the Application object 


Setting Up the Application 


+ workspace 

- loadNibFile: (const char *) filename 

owner: anObject 

- loadNibFile: (const char *) filename 

owner ‘.anObject 
withNames: (BOOL)/?ag 

- loadNibFile:(const char *) filename 

owner '.anObject 
withNames: (BOOL )flag 
fromZone:(NXZone *)zone 

- loadNibSection: (const char *)name 

owner '.anObject 

- loadNibSection:(const char *)name 

owner '.anObject 
withNames: (BOOL )flag 

- loadNibSection: (const char *)name 

owner uinObject 
withNames: (BOOL )flag 
fromHeader: (const struct mach_header *)header 

- loadNibSection:(const char *)name Loads objects built using Interface Builder 

owner '.anObject 
withNames:(BOOL)/? ag 
fromZone:(NXZone *)zone 

- loadNibSection:(const char *)name Loads objects built using Interface Builder 

owner: anObject 
withNames:(BOOL )flag 

fromHeader:(const struct mach_header *)header 
fromZone:(NXZone *)zone 


Returns the id of WorkspaceManager 
Loads objects built using Interface Builder 

Loads objects built using Interface Builder 

Loads objects built using Interface Builder 

Loads objects built using Interface Builder 
Loads objects built using Interface Builder 

Loads objects built using Interface Builder 


- (const char *)appName 

- setMainMenuraMcnu 

- mainMenu 


Returns the application’s name 

Makes aMenu the application’s main menu 

Returns the id of the application’s main menu 
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Responding to Notification (Override in a Subclass) 


- appIicationDidLaunch:appAfome 

- applicationDidTerminate '.appName 

- application WillLaunch:appAfame 


Notice that appName launched; your arbitrary return 
Notice that appName ended; your arbitrary return 
Notice that appName will launch; your arbitrary return 


Changing the Active Application 

- (int)acti\ate:(int)contextNumber 

- (int)activateSe!f:(BOOL)/?ag 

- (int)activeApp 

- becomeActiveApp 

- deactivateSelf 

- (BOOL)is Active 

- resignActiveApp 


Makes contextNumber the active application 

Makes this the active application 

Returns context number of the active application 

Responds to activating the application 

Deactivates the application 

Returns whether this is the active application 

Responds to deactivating the application 


Running the Event Loop 


-run 

- stop: sender 

- (int)runModalFor:r/2e Window 

- stopModal 

- stopModal :(int)returnCode 

- (void)abortModal 


Starts the main event loop 

Stops the main event loop 

Starts a modal event loop for theWindow 

Stops the modal event loop 

Stops the event loop started by runModalFor: 

Aborts the event loop started by runModalFor: 


- (NXModalSession *)beginModalSession:(NXModalSession *)session 

for ‘.theWindow Sets up a modal session with theWindow 

- (int)runModaISession:(NXModalSession *)session 

Runs a modal session 

- endModalSession:(NXModalSession *)session Finishes a modal session 

- delayedFreeitheObject Frees theObject after finishing the current event 

- (BOOL)isRunning Returns whether the main event loop is running 

- sendEvent:(NXEvent *)theEvent Dispatches events to other objects 


Getting and Peeking at Events 

- (NXEvent *)currentEvent Returns pointer to the current event 

- (NXEvent *)getNextEvent:(int)m«j , k Returns pointer to the next event matching mask 

- (NXEvent *)getNextEvent:(int)masfc Returns pointer to the next event matching mask 

waitFor:(double)n'meo«r 
threshold : (int )level 
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- (NXEvent *)peekAndGetNextEvent:(int)was& 

- (NXEvent *)peekNextEvent:(int)was£ 

into:(NXEvent *)eveiitPtr 

- (NXEvent *)peekNextEvent:(int)/7ja.y& 

into:(NXEvent *)eventPtr 
waitFor:(float )timeout 
threshold:(int)/ev<?/ 

Journaling 

- (BOOL)isJournalable 

- setJournalabIe:(BOOL)//ag 

- masterjournaler 

- slavejournaler 

Handling User Actions and Events 

- applicationDefined:(NXEvent *)theEvent 

- hide: sender 

- (BOOL)isHidden 

- (int)unhide 

- unhide '.sender 

- unhideWithout Activation: sender 

- powerOff:(NXEvent *)theEvent 

- (int)powerOffIn:(int)77w andSave:(int)tfF/ag 

- rightMouseDown:(NXEvent *)theEvent 

- (int)unmounting:(const char *)fullPath 

ok:(int *)flag 

Sending Action Messages 

- (B OOL)sendAction: (SEL)aSelector 

to’.aTarget 

from:sender 

- (BOOL)tryToPerform: (SEL)aSelector 

vath'.anObject 

- calcTargetForAction : (SEL)theAction 


Returns pointer to the next event matching mask 
Returns pointer to the next event matching mask 

Returns pointer to the next event matching mask 


Returns whether the application can be journaled 
Sets whether the application can be journaled 
Returns the controlling NXJoumaler object 
Returns the controlled NXJoumaler object 


Responds to an application-defined event 

Hides all the application’s windows 

YES if windows are hidden 

Responds to message to unhide windows 

Restores hidden windows to the screen 

Restores hidden windows without activating their owner 

Responds to a power-off subevent 

Responds to message from Workspace Manager 

Causes main menu to pop up under the mouse 

Responds to message from Workspace Manager 


Sends an action message to aTarget or up the responder 
chain 

Attempts to send a message to the application or the 
delegate 

Looks up receiver for theAction message 
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Remote Messaging 


- setAppListenenaLfs/ener 

- appListener 

- setAppSpeaker:aS/?ea£er 

- appSpeaker 

- (const char *)appListenerPortName 

- (port_t)replyPort 

Managing Windows 

- applcon 

- findWindow: (int) windowNum 

- getWindowNumbers:(int **)list 

count: (int *)winCount 

- key Window 

- mainWindow 

- makeWindowsPerform: (SEL )aSelector 

inOrder:(BOOL )flag 

- set Autoupdate: (BOOL)flag 

- update Windows 

- windowList 

- miniaturize All: 

- preventWindowOrdering 

Managing the Windows Menu 

- setWindowsMenuiaMenw 

- windowsMenu 

- arrangelnFront: 

- addWindowsItem:a Window 

title:(const char *)aString 
filcname:(BOOL)LsFilename 

- removeWindowsltem :aWindow 

- changeWindowsItem:aWm<iow 

title:(const char *)aString 
filename: (BOOL) isFilename 

- updateWindowsItem:aWmdc>vv 


Makes aListener the application’s Listener 

Returns the Listener for this application 

Makes aSpeaker the application’s Speaker 

Returns the Speaker for this application 

Returns name used to register Listener with name server 

Returns port for synchronous return messages 


Returns the Window with the application’s icon 
Returns Window object corresponding to windowNum 
Gets window numbers for the application’s windows 

Returns the the key window 

Returns the main window 

Sends aSelector message to the Windows 

Sets whether to send windows update messages 
Sends update message to all on-screen Windows 
Returns a List of the application’s Windows 
Miniaturizes all the receiver’s application windows 
Suppresses usual window ordering entirely 


Sets the Windows menu 

Returns the Windows menu 

Orders all registered Windows to the front 

Adds a menu item for aWindow 

Removes the Window’s menu item 
Changes the Window’s menu item 

Updates the Window’s menu item 
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Managing Panels 


- showHelpPanel:sender Shows the application’s help panel or default 

- orderFrontDataLinkPanel: Shows the shared instance; creates if need be 


Managing the Services menu 

- setServicesMenu :aMenu Sets the Services menu 

- servicesMenu Returns the Services menu 

- registerServicesMenuSendTypes: (const char *const *)sendTypes 

andReturnTypes: (const char *const *)returnTypes 


- validRequestorForSendType: 

(NXAtom)sendType 
andReturnType: (NX Atom) retu rn Type 

Managing Screens 

- (const NXScreen *)mainScreen 

- (const NXScreen *)colorScreen 

- getScreens: (const NXScreen **)list 

count: (int *)numScreens 

- getScreenSize:(NXSize *)theSize 

Querying the Application 

- (DPSContext)context 

- focus View 

- (const char *)hostName 

Reporting Current Languages 

- (const char *const *)systemLanguages 

Opening Files 

- (int)openFile: (const char *)fullPath 

ok:(int *)flag 

- (int)openTempFile: (const char *)fiillPath 

ok:(int *)flag 

- (int)fileOperationCompleted:(int)o/?eraf/on 


Registers pasteboard types the application can send/receive 

Indicates whether the Application can send and receive the 
specified types 


Returns the main screen 

Returns the best screen for color 

Gets information about every connected screen 

Provides the size of the screen in pixels 


Returns the Application’s DPS context 
Gets the currently lockFocus’ed View 
Returns machine running the Window Server 


Gets a list of the user’s preferred languages 


Asks the delegate to open the fullPath file 

Asks the delegate to open a temporary file 

Notification of completion of NXWorkspaceRequest; 
arbitrary operation and return 
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Responding to Devices 


-(int)mounted: (const char *)jullPath Notice that device at fullPath has been mounted; returns 0 

(unless overrideen in a subclass) 

- unmounted: (const char *)fiillPath Notice that device at fullPath has been unmounted; 

returns 0 (unless overrideen in a subclass) 


Printing 

- set Printlnfo://{/« 

- printlnfo 

- runPageLayouksender 


Makes info the application’s Printlnfo object 
Returns the application’s Printlnfo object 
Runs the application’s PageLayout panel 


Color 

- orderFrontColorPanel:sem/er 

- doesImportAlpha 

- setlmport Alpha: 


Brings up the color panel 

YES if application responds to opacity in imported colors 
Enable/disable response to opacity in imported colors 


Terminating the Application 

- terminat ^'.sender 


Frees the Application object and exits the application 


Assigning a Delegate 

Makes anObject the Application’s delegate 
Returns the Application’s delegate 


- seiDe\egate:anObject 

- delegate 


Implemented by the Delegate 

- app '.sender Notice that appName will launchf 

applicationWillLaunch: (const char *)appName 

- app '.sender Notice that appName launched! 

applicationDidLaunch:(const char *)appName 

- appWillInit:seAZfifer Notifies delegate before initializing! 

- appDidInit:sender Notifies delegate before getting first event! 
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- appDidBecomeActivetse/ider 

- appDidResignActive:se/ider 

- appDidHide:semfer 

- appDidUnhide render 

- appWillUpdaterseni/er 

- appDidUpdate render 

- (BOOL)appAcceptsAnotherFiIe:5en^er 

- (int)app '.sender 

openFile:(const char *)jilename 
type:(const char *)aType 

- (int)app '.sender 

openTempFile:(const char *) filename 
type:(const char *)aType 

- (NXDataLinkManager *)app '.sender 

openFileWithoutUI: (const char *) filename 
type:(const char *)aType 

- app '.sender 

fileOperationCompleted:(int)o/?eranon 

- appisender mounted:(const char *)fullPath 

- (mt)appisender 

unmounting:(const char *)fullPath 

- app '.sender 

unmounted: (const char *)jullPath 

- appWillTerminateisender 

- app '.sender 

vvillShowHelpPaneI:/;c//;t/ 

- app: sender 

powerOffln: (int)m,y 
andSave: (ml)aFlag 

- powerOff:(NXEvent *)theEvent 


Notifies delegate on activating the application 
Notifies delegate on deactivating the application 
Notifies delegate application has been hidden 
Notifies delegate application has been unhidden 
Notifies delegate application’s windows will be updated 
Notifies delegate on updating the application’s windows 
YES if it’s okay to open another filef 
Opens filename t 

Opens temporary file filename t 

Open application to run without user interface! 

Notice that operation completed; your arbitrary return! 

Notification that device at fullPath was mounted! 
Facilitates unmounting a device! 

Notification that device at fullPath was unmounted! 

Notification that application will terminate! 

Notification that sender will show panel 

Responds to message from Workspace Manager! 

Responds to a power-off subevent 


- app:sender Notification that application terminated! 

applicationDidTerminate: (const char *)appName 


! These methods may be defined in the delegate or in a 
subclass. If a method is implemented both in a subclass 
and in the delegate, the message is sent to the delegate. 
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Box 


Inherits From: View : Responder : Object 

Initializing and Freeing a Box 

- initFrame:(const NXRect *)frameRect Initializes a new Box object with the given frameRect 

- free Deallocates the Box 

Modifying the Border and Title 

- setBorderType:(int)a7ype 

- (int)borderType 

- setTitlePosition: (int)aPosition 

- (int)titlePosition 

- setTitle: (const char *)aString 

- (const char *)title 
-cell 

- setFont :fontObj 
-font 

Setting and Placing the Content View 

- setContentView:aV/evv 

- content View 

- setOffsets:(NXCoord)w :(NXCoord)/i 

- getOffsets:(NXSize *)aSize 

Putting Views in the Box 

- addSubview:^ 

- rcplaccSubviewraVi'ew with :anotherView 

Resizing the Box 

- setFrameFromContentFrame:(const NXRect *)contentFrame 

Resizes the Box to accommodate contentFrame 

- sizeTo:(NXCoord)w/dr/j :(NXCoord )height Resizes the Box to width and height 

- sizeToFit Resizes the Box to exactly enclose its subviews 


Adds aView as a subview of the content view 
Replaces aView with anotherView within the content view 


Replaces the Box’s content view with aView 
Returns the content view 

Sets the distance between the border and the content view 
Gets the distance between the border and the content view 


Sets the Box’s border to aType 
Returns the Box’s border type 
Sets the position of the title to aPosition 
Returns the position of the title 
Sets the Box’s title to aString 
Returns the title of the Box 
Returns the Cell used to draw the title 
Sets the Font of the title to fontObj 
Returns the Font used to draw the title 
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Drawing the Box 


- drawSelf:(const NXRect *)rects :(int )rectCount Draws the Box 


Archiving 

- awake 

- read:(NXTypedStream *)stream 

- write :(NXTypedStream *) stream 


Lays out the graphic elements of the Box 
Reads the Box object from the typed stream 
Writes the Box object to the typed stream 


Button 

Inherits From: Control : View : Responder : Object 


Initializing the Button Factory 

+ setCellC lass: class Id Sets the subclass of ButtonCell used by Button 


Initializing a Button 
-init 

- initFrame:(const NXRect *)frameRect 

- initFrame:(const NXRect *)frameRect 

icon:(const char *)iconName 

tag:(int )anlnt 

target :anObject 

action: (SEL )aSelector 

key:(unsigned short )charCode 

enabled:(BOOL)/?ag 

- initFrame:(const NXRect *)frameRect 

title:(const char *)aString 
tag:(int )anlnt 
target '.anObject 
action:(SEL)aSe/ector 
key:(unsigned short )charCode 
enabled:(BOOL)/7ag 


Initializes a new Button with title “Button” 

Initializes a new Button within frameRect 

Initializes a new Button within frameRect, 

with the NXImage named iconName as its icon, 

anlnt as its tag, 

anObject as its target object, 

aSelector as its action message, 

a key equivalent of charCode, 

and enabled according to flag 

Initializes a new Button within frameRect, 
with aString as its title, 
anlnt as its tag, 
anObject as its target object, 
aSelector as its action message, 
a key equivalent of charCode, 
and enabled according to flag 
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Setting the Button Type 

- setType:(int)a7y/?e 

Setting the State 

- setState:(int)ra/we 

- (int)state 

Setting the Repeat Interval 

- setPeriodicDelay: (float )delay 

andlnterval: (float )interval 

- getPeriodicDelay:(float *)delay 

andInterval:(float *) interval 

Setting the Titles 

- setTitle:(const char *)aString 

- setTitleNoCopy: (const char *)aString 

- (const char *)title 

- setAltTitle: (const char *)aString 

- (const char *)altTitle 


Sets how the Button highlights and shows its state 


Sets the Button’s state to value (0 or 1) 
Returns the Button’s current state (0 or 1) 


Sets repeat parameters for continuous Buttons 
Gets repeat parameters for continuous Buttons 


Makes aString the Button’s title 

Makes aString the Button’s title without copying it 

Returns the Button’s title 

Makes aString the Button’s alternate title 

Returns the Button’s alternate title 


Setting the Icons 

- setlcon:(const char *)iconName 

- setIcon:(const char *)iconName 

position: (int )aPosition 

- (const char *)icon 

- setAltIcon:(const char *)iconName 

- (const char *)altIcon 

- setlmag e:image 

- image 

- setAltlmag e:altlmage 

- altlmage 

- setIconPosition:(int)flPm/hoM 

- (int)iconPosition 


Makes the NXImage named iconName the Button’s icon 
Sets the icon by name, and its position 

Returns the name of the Button’s icon 

Makes the NXImage named iconName the alternate icon 

Returns the name of the Button’s alternate icon 

Makes the NXImage image the Button’s icon 

Returns the Button’s image 

Makes the NXImage image the alternate icon 

Returns the Button’s alternate image 

Sets the position of the Button’s icon 

Returns the position of the Button’s icon 
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Modifying Graphic Attributes 

- setTransparent:(BOOL)/fag 

- (BOOL)isTransparent 

- setBordered:(BOOL]/?ag 

- (BOOL)isBordered 

Displaying 

- display 

- highlight :(BOOlflflag 

Setting the Key Equivalent 

- setKeyEquivalent: (unsigned short )charCode 

- (unsigned short)keyEquivalent 

Handling Events and Action Messages 


Sets whether the Button is transparent 
Returns whether the Button is transparent 
Sets whether the Button has a bezeled border 
Returns whether the Button has a bezeled border 


Displays the Button 

Highlights (or unhighlights) the Button according to flag 


Makes charCode the Button’s key equivalent 
Returns the Button’s key equivalent 


- (BOOL)acceptsFirstMouse Ensures that the Button accepts first mouse-down 

- performClickrsender Simulates the user clicking the Button 

- (BOOL)performKeyEquivalent:(NXEvent *)theEvent 

Simulates a mouse click, if the key is right 


Setting the Sound 

- setSound isoundObject Sets the Sound played when the Button is pressed 

- sound Returns the Sound played when the Button is pressed 


ButtonCell 

Inherits From: ActionCell: Cell: Object 

Initializing, Copying, and Freeing a ButtonCell 

- init Initializes a new ButtonCell with title “Button” 

- initTextCell:(const char *)aString Initializes a new ButtonCell with title aString 
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- initlconCell: (const char *)iconName 

- copyFromZone:(NXZone *)zone 
-free 


Initializes a new ButtonCell with an NXImage named 
iconName as its icon 

Returns a copy of the ButtonCell allocated from zone 
Deallocates the ButtonCell 


Determining Component Sizes 

- calcCellSize:(NXSize *)theSize 

inRect:(const NXRect *)aRect 

- getDrawRect: (NXRect *)theRect 

- getTitleRect: (NXRect *)theRect 

- getlconRect: (NXRect *)theRect 


Calculates and returns the size of the ButtonCell 

Returns the rectangle the ButtonCell draws in 
Returns the rectangle the title is drawn in 
Returns the rectangle the icon is drawn in 


Setting the Titles 

- setTitle: (const char *)aString 

- setTitleNoCopy:(const char *)aString 

- (const char *)title 

- setAltTitle:(const char *)aString 

- (const char *)altTit!e 

- setFont'.f ontObject 


Makes a copy of aString the ButtonCell’s title 
Makes aString the ButtonCell’s title without copying it 
Returns the ButtonCell’s title 

Makes a copy of aString the ButtonCell’s alternate title 
Returns the ButtonCell’s alternate title 
Sets the Font used to draw the title 


Setting the Icons 

- setIcon:(const char *)iconName 

- (const char *)icon 

- setAltlcon: (const char *)ico?iName 

- (const char *)altIcon 

- setlmage:/wage 
-image 

- setAltlmag eialtlmage 

- altlmage 

- setlconPosition: (mt)aPosition 

- (int)iconPosition 


Makes the NXImage named iconName the ButtonCell’s 
icon 

Returns the name of the ButtonCell’s icon 

Makes the NXImage named iconName the ButtonCell’s 
alternate icon 

Returns the name of the ButtonCell’s alternate icon 

Makes the NXImage object image the ButtonCell’s icon 

Returns the ButtonCell’s icon 

Makes the NXImage object image the alternate icon 

Returns the ButtonCell’s alternate icon 

Sets the position of the ButtonCell’s icon to aPosition 

Returns the position of the ButtonCell’s icon 
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Setting the Sound 

- setSound uzSound 

- sound 

Setting the State 

- setDoubleValue:(double)aDoM&/e 

- (double)double Value 

- setFloatValue:(float)aF7oat 

- (float)floatValue 

- setIntValue:(int )anlnt 

- (int)intValue 

- setStringValue:(const char *)aString 

- setStringValueNoCopy:(const char *)aString 

- (const char *)stringValue 

Setting the Repeat Intervae 

- setPeriodicDelay:(float )delay 

andInterval:(float )interval 

- getPeriodicDelay: (float *)delay 

andInterval:(float *) interval 

Tracking the Mouse 

- (BOOL)trackMouse:(NXEvent *)theEvent 

inRect: (const NXRect *)cellFrame 
ofView icontrolView 

Setting the Key Equivalent 

- setKeyEquivalent:(unsigned short)charCode 

- setKeyEquivalentFont ifontObj 

- setKeyEquivalentFont:(const char *)fontName 

size: (float )fontSize 

- (unsigned short)keyEquivalent 


Sets the Sound played by the ButtonCell on a mouse-down 
Returns the Sound played by the ButtonCell 


Sets the ButtonCell’s state (value) to aDouble 

Returns the ButtonCell’s state as a double 

Sets the ButtonCell’s state (value) to aFloat 

Returns the ButtonCell’s state as a float 

Sets the ButtonCell’s state (value) to anlnt 

Returns the ButtonCell’s state as an int 

Sets the ButtonCell’s state (value) to a copy of aString 

Sets the ButtonCell’s state (value) to aString 

Returns the ButtonCell’s state as a string 


Sets repeat parameters for continuous ButtonCells 
Gets repeat parameters for continuous ButtonCells 


Plays the Sound, then tracks the mouse 


Sets the ButtonCell’s key equivalent 

Sets the Font used to draw the key equivalent 

Sets the Font and size used to draw the key equivalent 

Returns the ButtonCell’s key equivalent 
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Setting Parameters 

- seiParameter:(int)aParameter to:(int )value 

- (int)getParameter:(int)tfParameter 

Modifying Graphic Attributes 

- setBordered:(BOOL)/?ag 

- (BOOL)isBordered 

- setTransparent:(BOOL)y/ag 

- (BOOL)isTransparent 

- (BOOL)isOpaque 

Modifying Graphic Attributes 

- setType^inOaTjjpe 

- setHighlightsBy:(int)a7y/?e 

- (int)highlightsBy 

- setShowsStateBy:(int)a7y/?e 

- (int)showsStateBy 

Simulating a Click 

- performCIick: sender 

Displaying 

- drawlnside:(const NXRect *)aRect 

inView icontrolView 

- drav/Self: (const NXRect *)cellFrame 

inView icontrolView 

- highlight:(const NXRect *)cellFrame 

inView icontrolView 
lit:(BOOL )flag 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStreara *)stream 


Sets various flag values 
Returns various flag values 


Sets whether the ButtonCell has a bezeled border 
Returns whether the ButtonCell has a bezeled border 
Sets whether the ButtonCell is transparent 
Returns whether the ButtonCell is transparent 
Returns whether receiver is opaque 


Sets the ButtonCell’s display behavior 

Sets how the ButtonCell highlights 

Returns how the ButtonCell highlights 

Sets how the ButtonCell shows its alternate state 

Returns how ButtonCell shows its alternate state 


Simulates clicking the ButtonCell 


Draws the inside of the ButtonCell 
Draws the ButtonCell 
Highlights the ButtonCell 


Reads the ButtonCell from stream 
Writes the ButtonCell to stream 
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Cell 


Inherits From: Object 

Initializing, Copying, and Freeing a Cell 

- init Initializes a new Cell 

- initIconCell:(const char *)iconName Initializes a new Cell with the NXImage named iconName 

- initTextCell:(const char *)aString Initializes a new Cell with title aString 

- copyFromZone:(NXZone *)zone Returns a copy of the receiving Cell from zone 

- free Deallocates the Cell 


Determining Component Sizes 

- calcCellSize:(NXSize *)theSize 

-calcCellSize:(NXSize *)theSize 

inRect:(const NXRect *)aRect 

- calcDrawInfo:(const NXRect *)aRect 

- getDrawRect:(NXRect *)theRect 

- getIconRect:(NXRect *)theRect 

- getTitleRect: (NXRect *)theRect 

Setting the Cell's Type 

- setType:(int)a7ype 

- (int)type 

Setting the Cell's State 

- setState:(int)va/«e 

- incrementState 

- (int)state 

Enabling and Disabling the Cell 

- setEnabled:(BOOL)//ag 

- (BOOL)isEnabled 


Returns the minimum size needed to display the Cell 
Returns the minimum size needed to display the Cell 

Implemented by subclasses to recalculate drawing sizes 
Returns the rectangle the Cell draws in 
Returns the rectangle that an icon is drawn in 
Returns the rectangle that a title is drawn in 


Sets the Cell’s type to aType 
Returns the Cell’s type 


Sets the state of the Cell to value (0 or 1) 
Increments the state of the Cell 
Returns the state of the Cell (0 or 1) 


Sets whether the Cell reacts to mouse events 
Returns whether the Cell reacts to mouse events 
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Setting the Icon 


- setlcon: (const char *)iconName 

- (const char *)icon 

Setting the Cell's Value 

- setDoubleVaIue:(double)tfDonWe 

- (double)doubleValue 

- setFloat Value: (float)aF/oa/ 

- (float)float Value 

- setIntVaIue:(int)an/«r 

- (int)intValue 

- setStringValue:(const char *)aString 

- setStringVa!ueNoCopy:(const char *)aString 

- setStringValueNoCopy:(char *)aString 

shouldFree: (BOOL )fiag 

- (const char *)stringVa!ue 

Interacting with Other Cells 

- takeDoubleValueFrom:sercder 

- takeFIoatValueFrom:.se/zc/<?r 

- takelntValueFronKsender 

- takeStringVaiueFromimz^cr 

Modifying Text Attributes 

- setAlignment:(int)m 0 <ie 

- (int)alignment 

- setFont ifontObject 
-font 

- setEditable:(BOOL)/7ag 

- (BOOL)isEditable 

- setSe!ectable:(BOOL)/fag 

- (BOOL)isSelectable 

- setScro!lable:(BOOL)/?flg 

- (BOOL)isScrollable 

- setTextAttributes:totf0£>/ect 

- setWrap:(BOOL)/?ag 


Sets the Cell’s icon to the NXImage named iconName 
Returns the name of the Cell’s icon 


Sets the Cell’s value to aDouble 
Returns the Cell’s value as a double 
Sets the Cell’s value to aFloat 
Returns the Cell’s value as a float 
Sets the Cell’s value to anlnt 
Returns the Cell’s value as an int 
Sets the Cell’s value to a copy of aString 
Sets the Cell’s value to aString 

Sets the Cell’s value to aString ; will free the string when 
freed if flag is YES 

Returns the Cell’s value as a string 


Sets the Cell’s value to sender's double Value 
Sets the Cell’s value to sender's floatValue 
Sets the Cell’s value to sender's intValue 
Sets the Cell’s value to sender's stringValue 


Sets the alignment of text in the Cell to mode 

Returns the alignment of text in the Cell 

Sets the Font used to display text in the Cell to fontObject 

Returns the Font used to display text in the Cell 

Sets whether the Cell’s text is editable 

Returns whether the Cell’s text is editable 

Sets whether the Cell’s text is selectable 

Returns whether the Cell’s text is selectable 

Sets whether the Cell scrolls to follow typing 

Returns whether the Cell scrolls to follow typing 

Sets Text parameters for drawing or editing 

Sets whether the Cell’s text is word-wrapped 
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Editing Text 

- edit:(const NXRect *)aRect 

inVievr.aView 
editor: textObject 
delegat eianObject 
event:(NXEvent *)theEvent 

- endEditing:textObject 

- select:(const NXRect *)aRect 

iiiView^Vfew 
editor:textObject 
delegat e:anObject 
start:(mt)selStart 
length:(in t)selLength 

Validating Input 

- setEntryType:(int)a7y/?e 

- (int)entryType 

- (BOOL)isEntryAcceptable:(const char *)aString 

Formatting Data 

- setFloatingPointFormat:(BOOL)auto7taftge 

left: (unsigned )leftDigits 
right: (unsigned )rightDigits 

Modifying Graphic Attributes 

- setBezeled:(BOOL)/fag 

- (BOOL)isBezeled 

- setBordered:(BOOL)//<3g 

- (BOOL)isBordered 

- (BOOL)isOpaque 

Setting Parameters 

- setParameter:(int )aParameter to:(int )value 

- (int)getParameter: (int )aParameter 


Allows text editing in response to a mouse-down event 


Ends any text editing occurring in the Cell 

Allows text selection in response to a mouse-down event 


Sets the type of data the user can type into the Cell 
Returns the type of data the user can type into the Cell 
Returns whether aString is acceptable for the entry type 


Sets the display format for floating point values 


Sets whether the Cell has a bezeled border 
Returns whether the Cell has a bezeled border 
Sets whether the Cell has a plain border 
Returns whether Cell has a plain border 
Returns whether the Cell is opaque 


Sets various Cell flags 
Returns various Cell flag values 
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Displaying 

- controlView 

- drawInside:(const NXRect *)cellFrame 

inViewraV/cvv 

- drawSelf:(const NXRect *)cellFrame 

inView:flV7ew 

- highlight: (const NXRect *)cellFrame 

inView:aV7ew 

lit:(BOOL)//ag 

- (BOOL)isHighlighted 

Target and Action 

- setAction:(SEL)aSWecfor 

- (SEL)action 

- setTargetianObject 

- target 

- setContinuous:(BOOL)/Zag 

- (BOOL)isContinuous 

- (int)sendActionOn:(int)wa^/: 

Assigning a Tag 

- setTag:(int)tf«/nt 

- (int)tag 

Handling Keyboard Alternatives 

- (unsigned short)keyEquivalenl 

Tracking the Mouse 

+ (BOOL)prefersTrackingUntilMouseUp 

- (int)mouseDownFlags 

- getPeriodicDelay:(float*)fi?e/ay 

andInterval:(float*)mteraj/ 

- (BOOL)trackMouse:(NXEvent *)theEvent 

inRect:(const NXRect *)cellFrame 
ofView \aView 


Implemented by subclasses to return the View last drawn in 
Draws the area within the Cell’s border in aView 

Draws the Cell in aView 

Highlights the Cell according to flag in aView 

Returns whether the Cell is highlighted 


Implemented by subclasses to set the action method 
Implemented by subclasses to return the action method 
Implemented by subclasses to set the target object 
Implemented by subclasses to return the target object 
Sets whether the Cell continuously sends action 
Returns whether the Cell continuously sends action 
Determines when the action is sent while tracking 


Implemented by subclasses to set an identifier tag 
Implemented by subclasses to return the identifier tag 


Implemented by subclasses to return a key equivalent 


Returns NO, so tracking stop when the mouse leaves the 
Cell; subclasses may override 

Returns the event flags set at the start of mouse tracking 
Returns repeat values for continuous sending of the action 

Controls tracking behavior of the Cell 
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- (BOOL)startTrackingAt:(const NXPoint *)startPoint 

inView:aV7evv Determines whether tracking should begin base on 

start Point within aView 

- (BOOL)continueTracking:(const NXPoint *)lastPoint 

at:(const NXPoint *)currentPoint 
inView: aView 

- stopTracking:(const NXPoint *)lastPoint 

at:(const NXPoint *)stopPoint 
inView :aView 
mouselsU p: (BOOL)flag 

Managing the Cursor 

- resetCursorRect: (const NXRect *)cellFrame Sets text Cells to show I-beam cursor 

inView:flVYevv 


Returns whether tracking should continue based on 
lastPoint and currentPoint within aView 

Allows the Cell to update itself to end tracking, based on 
lastPoint, stopPoint, within aView, flag is YES if the 
this method was invoked because mouse went up 


Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 

- awake 


Reads the Cell from stream 
Writes the Cell to stream 
Reinitializes the Cell after being read 


ClipView 


Inherits From: View : Responder : Object 

Initializing the Class 

+ initialize Initializes the ClipView class 

Initializing and Freeing a ClipView 

- initFrame:(const NXRect *)frameRect Initializes a new ClipView instance 

- free Releases the Clip View’s storage 


Classes: ClipView 


2-21 



Modifying the Frame Rectangle 

- moveTo:(NXCoord)x :(NXCoord)y 

- rotateTo:(NXCoord)arcg/<? 

- sizeTo:(NXCoord)vv/<M :(NXCoord)/ 2 ez'g/z/ 

Modifying the Coordinate System 

- rotate:(NXCoord)ang/e 

- scale :(NXCoord)x :(NXCoord)y 

- setDrawOrigin:(NXCoord)jc :(NXCoord)y 

- setDrawRotation:(NXCoord)a«g/e 

- setDrawSize:(NXCoord)vv/J//z :(NXCoord)/zeig/zf 

- translate:(NXCoord)x :(NXCoord)y 

Managing Component Views 

- docView 

- setDoc Vie w:a View 

- getDocRect:(NXRect *)aRect 

- getDocVisibleRect:(NXRect *)aRect 

- resetCursorRects 

- setDocCursor:an06/ 

Modifying Graphic Attributes and Displaying 

- (float)backgroundGray 

- setBackgroundGray: (float) value 

- (NXColor)backgroundColor 

- setBackgroundColor:(NXColor)co/or 

- drawSelf:(const NXRect *)rects :(int )rectCount 

Scrolling 

- autoscroll:(NXEvent *)theEvent 

- constrainScroll:(NXPoint *)newOrigin 

- rawScroll: (const NXPoint *)newOrigin 

- setCopyOnScroII:(BOOL)/7ag 

- setDisplayOnScroIl:(BOOL)^ag 


Moves the origin of the frame rectangle 
Overridden to disable rotation 
Resizes the Clip View’s frame 


Overriden to disable rotation 
Rescales the coordinate system 
Sets the origin of the coordinate system 
Disables rotation of the coordinate system 

Scales the coordinate system 
Shifts the coordinate system 


Returns the Clip View’s document view 
Makes aView the Clip View’s document view 
Returns the document rectangle 
Gets the visible portion of the document view 
Resets the cursor rectangle for the document view 
Sets the cursor for the document view 


Returns the Clip View’s background gray 
Sets the ClipView’s background gray 
Returns the ClipView’s background color 
Sets the ClipView’s background color 
Fills the background gray where needed 


Scrolls in response to mouse-dragged events 

Prevents scrolling to an undesirable position 

Lowest-level unconstrained scrolling routine 

Sets how the visible areas are redrawn 

Sets how the document view is displayed during scrolling 
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Coordinating with Other Views 

- descendantFlipped render 

- descendantFrameChanged^e/j^r 

Archiving 

- awake 

- read:(NXTypedStream *)stream 

- write: (NXTypedStream *)stream 

Implemented by ClipView's Superview 

- reflectScrolhaClipView 

- scrolIClip laClipView to:(const NXPoint *)aPoint 


Control 

Inherits From: View : Responder : Object 

Initializing and Freeing a Control 

- initFrame: (const NXRect *)frameRect 
-free 

Setting the Control's Cell 

+ setCellClass ’.class Id 

- setCell: aCell 
-cell 

Enabling and Disabling the Control 

- setEnab!ed:(B00L)/7ag 

- (BOOL)isEnabled 


Notification that the document’s orientation has changed 
Notification that the document’s frame has changed 


Initializes the Clip View after unarchiving 
Reads the Clip View from the typed stream 
Writes the Clip View to the typed stream 


Notifies the superview to update indicators 
Notifies the superview of a scroll 


Initializes a new Control 
Deallocates the Control 


Implemented by subclasses to set the Cell class used 
Sets the Control’s Cell to aCell 
Returns the Control’s Cell 


Sets whether the Control reacts to mouse events 
Returns whether the Control reacts to mouse events 
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Identifying the Selected Cell 

- selectedCell 

- (int)selectedTag 

Setting the Control's Value 

- setDoubleValue: (doub\e)aDouble 

- (double)doubleValue 

- setFloat Value: (float)aFZoa/ 

- (float)float Value 

- setIntValue:(int)tf/z/m 

- (int)int Value 

- setStringValue: (const char *)aString 

- setStringValueNoCopy: (const char *)aString 

- setStringValueNoCopy:(char *)aString 

shouldFree:(BOOL)/7ag 

- (const char *)stringValue 

Interacting with Other Controls 

- takeDoubleValueFronuscnofer 

- takeFloatValueFrom:sender 

- takeIntValueFrom:.serc<&T 

- takeString ValueFronusewder 

Formatting Text 

- setAlignment:(int)mo7&? 

- (int)alignment 

- setFonUfontObject 

- font 

- setFIoatingPointFormat:(BOOL)azztoiforcge 

left:(unsigned)leftDigits 

right:(unsignQd)rightDigits 

Managing the Field Editor 

- abortEditing 

- currentEditor 

- validateEditing 


Returns the Control’s selected Cell 
Returns the tag of the Control’s selected Cell 


Sets the Control’s value to aDouble 
Returns the Control’s value as a double 
Sets the Control’s value to aFloate 
Returns the Control’s value as a float 
Sets the Control’s value to anlnt 
Returns the Control’s value as an int 
Sets the Control’s value to aString 
Sets the Control’s value to aString 
Sets the Control’s value to aString 

Returns the Control’s value as a string 


Sets the Control’s value to sender's double Value 
Sets the Control’s value to sender's floatValue 
Sets the Control’s value to sender's int Value 
Sets the Control’s value to sender's stringValue 


Sets the alignment of text in the Control to mode 

Returns the alignment of text in the Control 

Sets the Font used to draw text in the Control to fontObject 

Returns the Font used to draw text in the Control 

Sets the display format for floating point values 


Aborts editing of text displayed by the Control 
Returns the object used to edit text in the Control 
Validates the user’s changes to editable text 
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Managing the Cursor 

- resetCursorRects 


Sets text-bearing Controls to show an I-beam cursor 


Resizing the Control 

- calcSize 

- sizeTo:(NXCoord )width :(NXCoord )height 

- sizeToFit 

Displaying the Control and Cell 

- drawCellmCe/Z 

- drawCelllnsidemCe// 

- drawSelf:(const NXRect *)rects :(int )rectCount 

- selectCell :aCell 

- update 

- updateCell :aCell 

- updateCellInside:aCe// 

Target and Action 

- setAction:(SEL)aSe/<?ctor 

- (SEL)action 

- setTargetianObject 

- target 

- setContinuous:(BOOL)//ag 

- (BOOL)isContinuous 

- send Action: (SEL)//iMcnon touheTarget 

- (int)sendActionOn:(int)raasA: 

Assigning a Tag 

- setTag:(int )anlnt 

- (int)tag 

Tracking the Mouse 

- ignoreMultiClick:(BOOL)/?ag 

- mouseDown:(NXEvent *)theEvent 

- (int)mouseDownFlags 


Recalculates internal size information 
Resizes the Control to width and height 
Resizes the Control to fit its Cell 


Redraws aCell if it’s the Control’s Cell 

Redraws aCell' s inside if it’s the Control’s Cell 

Draws the Control 

Selects aCell if it’s the Control’s cell 

Redisplays the Control or marks it for later redisplay 

Redisplays aCell or marks it for redisplay 

Redisplays the inside of aCell or marks it for redisplay 


Sets the Control’s action method to aSelector 

Returns the Control’s action method 

Sets the Control’s target object to anObject 

Returns the Control’s target object 

Sets whether the Control continuously sends its action 

Returns whether the Control continuously sends its action 

Has the Application object send theAction to theTarget 

Determines when the action is sent while tracking 


Sets the Control’s tag to anlnt 
Returns the Control’s tag 


Sets whether multiple clicks are ignored 
Handles a mouse-down event in the Control 
Returns flags in effect at beginning of tracking 
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Archiving 


- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Reads the Control from stream 
Writes the Control to stream 


Font 


Inherits From: Object 

Initializing the Class Object 

+ initialize 

+ useFont:(const char *)fontName 

Creating and Freeing a Font Object 

+ newFont: (const char *)fontName 
size:(hoat)fontSize 

+ newFont:(const char *)fontName 
size:(f\oat)fontSize 
matrix:(const float *)fontMatrix 

+ newFont:(const char *)fontName 
size:(f\oat)fontSize 
style:(int)fontStyle 
matrix: (const float *)fontMatrix 

+ boldSystemFontOfSize:(float)/bnfS , ize 
matrix:(const float *)fontMatrix 

+ userFixedPitchFontOfSize:(float)/<?ntiS7ze 
matrix: (const float *)fontMatrix 

+ userFontOfSize:(float)/cwAS7ze 

matrix:(const float *)fontMatrix 

+ systemFontOfSize:(float)/oflrS7z<? 

matrix:(const float *)fontMatrix 

- free 


Performed automatically at start-up 
Registers that fontName is used in the document 


Returns the specified Font object 
Returns the specified Font object 

Returns the specified Font object 


Returns the Font object representing the bold system 
font of size fontSize and matrix fontMatrix 

Returns the Font object representing the application’s 
fixed-pitch font of size fontSize and matrix fontMatrix 

Returns the Font object representing the application’s 
standard font of size fontSize and matrix fontMatrix 

Returns the Font object representing the system 
font of size fontSize and matrix fontMatrix 

Has no effect 
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Querying the Font Object 

- (const float *)displayName 

- (const float *)familyName 

- (const char *)name 

- (int)fontNum 

- (float)getWidthOf:(const char *)string 

- (BOOL)hasMatrix 

- (const float *)matrix 

- (NXFontMetrics *)metrics 

- (float)pointSize 

- (NXFontMetrics *)readMetrics:(int)y?a^5 

- screenFont 

- (int)style 

Setting the Font 

- set 

- setStyle:(int)aSfy/e 

+ setUserFixedPitchFont:(Font *)aFont 
+ setUserFont:(Font *)aFont 

Archiving 

- awake 

- finishUnarchiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Returns the full name of the font 

Returns the name of the font’s family 

Returns the name of the font 

Returns the Window Server’s font number 

Returns the width of string in this font 

Returns whether font differs from identity matrix 

Returns a pointer to the font matrix 

Returns pointer to a record of font information 

Returns the size of the font in points 

Reads flags information into the font record 

Returns the screen font for this font 

Returns the font style 


Makes this font the graphic state’s current font 
Sets the Font’s style 

Sets the fixed-pitch font used by default in the application 
Sets the standard font used by default in the application 


Reinitializes the Font object 
Checks whether the Font object already exists 
Reads the Font object from the typed stream 
Writes the Font object to the typed stream 


ForitManager 


Inherits From: Object 

Creating a FontManager 

+ new Returns the application-wide FontManager 
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Converting Fonts 

- convertFonE/on/OZy 

- convertWeight:(B OOL)npFlag ofifontObj 

- con\ert:fontObj toFace:(const char *)typeface 

- conver UfontObj toFamily:(const char *)family 

- con\ert:fontObj toSize:(float).s7ze 

- comertifontObj 

toHaveTrait:(NXFontTraitMask)rrah 

- conver UfontObj 

toNotHaveTrait:(NXFontTraitMask)fra/f 

- findFont:(const char *)family 

traits :(NXFontTraitMask)rra/^ 

weight:(int)wezg/tf 

size:(float)5z'ze 

- getFamily:(const char **)family 

traits:(NXFontTraitMask *)traits 
weight:(int *)weight 
size:(float *)size 
ofFo n t :fon tObj 

Setting Parameters 

- set Action :(SEL)aSelector 

+ setFontPaneIFactory:c/<xs\s7<7 
+ setFontManagerFactoryic/zm/d 

- setSelFontzfontObj isMultiple:(BOOL)/?ag 

- setEnabled:(BOOL]/fag 

Querying Parameters 

- (SEL)action 

- (char **)availabIeFonts 

- getFontMenu:(BOOL)create 

- getFontPanel:(BOOL)create 

- (BOOL)isMultiple 

- selFont 

- (BOOL)isEnabled 


Converts the font in response to changeFont: 

Raises or lowers the weight of the font 
Converts the font to the specified typeface 
Converts the font to the specified family 
Converts the font to the specified point size 
Converts the font to have the specified trait 

Converts the font to remove the specified trait 

Tries to find a font that matches the specified characteristics 


Provides the characteristics of the given fontObj 


Sets the action sent by the FontManager 
Sets the class used to create the Font panel 
Sets the class used to create the font manager 
Notifies FontManager of selection’s current font 
Enables and disables the Font panel and menu 


Gets the action sent by the FontManager 
Provides a list of all available fonts 
Returns the Font menu 
Returns the Font panel 

Returns whether selection contains multiple fonts 
Returns the first font in the current selection 
Returns whether the Font panel and menu are enabled 
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Target and Action Methods 

- modifyFontoe/jder 

- addFontTrait '.sender 

- removeFontTrait:s< 2 / 2 <ier 

- modifyFontViaPanelrsender 

- orderFrontFontPanelrsender 

- sendAction 

Assigning a Delegate 

- setDelegateranOb/ect 

- delegate: 

Archiving the FontManager 

- finishUnarchiving 


FontPanel 

Inherits From: 

Creating a FontPanel 

+ new 

+ newContent: (const NXRect *)contentRect 
style:(int)aStyle 
baddng:(int)bufferingType 
buttonMask: (int )mask 
defer: (BOOL )flag 

Setting the Font 

- setPanelFont:/ontO£y isMultiple:(B OOL)flag 

- panelConvertFont:/ontC%' 


Converts current selection’s font 

Causes trait to be added to font in current selection 

Causes trait to be removed from font in current selection 

Converts font according to Font panel settings 

Orders the FontPanel front 

Dispatches action message up responder chain 


Sets the FontManager’s delegate 
Returns the FontManager’s delegate 


Finishes unarchiving by creating the FontManager 


Returns a FontPanel object 
Returns a FontPanel object 


Sets the Font panel’s current font 

Converts fontObj to the user’s choice from the panel 


Panel: Window : Responder : Object 
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Configuring the FontPanei 


- accessory View 

- set Accessory Vie w:a View 

- setEnabled:(BOOL)/ag 

- (BOOL)isEnabled 

- (BOOL)worksWhenModal 

Editing the FontPanel's Fields 

- textDitiExuktextObject 

endChar:(unsigned short )endChar 

- textDidGetKeys :textObject isEmpty: (B OOL)flag 

Displaying the FontPanei 

- orderWindow:(int)p/ace relativeTo:(int)ot/ 2 erWn 


Returns the application-customized view 
Adds application-customized View to the FontPanei 
Enables and disables the FontPanel’s Set button 
Returns whether the FontPanel’s Set button is enabled 

Returns whether FontPanei works when another window is 
modal 


Detects completion of size field editing 

Detects empty size field 


Repositions panel and updates it if necessary 


Resizing the FontPanei 

- windowWiIIResize:senrfer Constrains FontPanei resizing 

toSize:(NXSize *)frameSize 


Form 

Inherits From: Matrix : Control: View : Responder : Object 

Setting Form's Cell Class 

+ sctCe\lClass:classId Sets the subclass of Cell used by Form 

Initializing a Form 

- initFrame:(const NXRect *)frameRect Initializes a new Form in frameRect 
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Laying Out the Form 


- addEntry:(const char *)title 

- addEntry:(const char *)title 

tag:(int)anlnt 
target :anObject 
action:(SEL )aSelector 

- insertEntry:(const char *)title at:(int )index 

- insertEntry:(const char *)title 

at:(int)index 
tag:(int)anlnt 
target: anObject 
action: (SEL)aSelector 

- removeEntryAt:(int)m^cjc 

- setlnterline: (NXCoord )spacing 

Assigning a Tag 

- setTag:(int)a/i//it at:(int)index 

Finding Indices 

- (int)findIndexWithTag:(int)a7ag 

- (int)selectedlndex 

Modifying Graphic Attributes 

- setBezeIed:(BOOL)//ag 

- setBordered:(BOOL)//ag 

- setFont :font Object 

- setTitleFont \fontObject 

- setTextFontifontObject 

- setTitleAlignment: (int)mode 

- setTextAlignment:(int)moJe 

Setting Item Titles 

- setTitle:(const char *)aString at:(int )index 

- (const char *)titleAt:(int)m(ie;c 


Adds a new entry with title as its title at the end of the Form 

Adds a new entry with title as its title at the end of the Form 
and sets its tag, target, and action 

Inserts a new entry with title as its title at index 

Inserts a new entry with title as its title at index and sets 
its tag, target, and action 


Removes the entry at index 
Sets the spacing between entries 


Sets the tag of the entry at index to anlnt 


Returns the index for the entry with tag aTag 
Returns the index of the currently selected entry 


Sets whether entries have a bezeled border 

Sets whether the entries have a plain border 

Sets the Font used to draw both titles and text 

Sets the Font used to draw entry titles 

Sets the Font used to draw entry text 

Sets how titles are aligned 

Sets how text is aligned within the entries 


Sets the title of the entry at index to aString 
Returns the title of the entry at index 
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Setting Item Values 

- setDoubleValue:(double)aZ> 0 z/&/e at:(int)mzfec 

- (double)doubleVaIueAt:(int)z/zzfec 

- setFloatValue:(float)aF/<9flr <it:(int)index 

- (float)floatValueAt:(int)m<f£* 

- setIntVaIue:(int)an/n? at:(int)index 

- (int)int Value At :(int)zWeje 

- setStringValue:(const char *)aString at:(int )index 

- (const char *)stringValue At: (m\)index 

Editing Text 

- selectTextAt:(int)mzfer 

Resizing the Form 

- calcSize 

- setEntry Width: (NXCoord)wzVfr/z 

- sizeTo :(NXCoord) wz'zfr/z :(NXCoord)/z<?/g/zt 

- sizeToFit 

Displaying 

- drawCellAt:(int)zn<iex 

Target and Action 

- set Action: (SEL)a5'c/ector at:(int)zWex 

- setTarget:anObject at:(int )index 


Sets the value of the entry at index to aDouble 
Returns the value of the entry at index as a double 
Sets the value of the entry at index to aFloat 
Returns the value of the entry at index as a float 
Sets the value of the entry at index to a anlnt 
Returns the value of the entry at index as an int 

Sets the value of the entry at index to a aString 
Returns the value of the entry at index as a string 


Selects the text in the entry at index 


Recalculates title positions in the Form 

Sets the width of all the entries 

Resizes the Form and updates the widths of its entries 

Modifies the Form’s frame to fit its entries 


Displays the Cell at the specified index 


Sets the action method of the entry at index to aSelector 
Sets the target object of the entry at index to anObject 
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FormCell 


Inherits From: ActionCell: Cell: Object 

Initializing, Copying, and Freeing a FormCell 

- init 

- initTextCell: (const char *)aString 

- copyFromZone:(NXZone *)zone 
-free 

Determining a FormCell's Size 

- calcCellSize:(NXSize *)theSize 

inRect: (const NXRect *)aRect 

Enabling the FormCell 

- setEnabled:(BOOL)/Zag 

Modifying the Title 

- setTitle: (const char *)aString 

- (const char *)title 

- setTitleFonUfontObject 

- titleFont 

- setTitleAlignment:(int)mo<ie 

- (int)titleAlignment 
-setTitleWidth:(NXCoord)wzV/t/i 

- (NXCoord)titleWidth:(const NXSize *)aSize 

- (NXCoord)title Width 

Modifying Graphic Attributes 

- (BOOL)isOpaque 


Initializes a new FormCell with “Field” as its title 
Initializes a new FormCell with aString as its title 
Returns a copy of the FormCell allocated from zone 
Deallocates the FormCell 


Calculates the FormCell’s size within aRect 


Sets whether the FormCell reacts to events 


Sets the FormCell’s title to aString 

Returns the FormCell’s title 

Sets the Font used to draw the title 

Returns the Font used to draw the title 

Sets the alignment of the title 

Returns the alignment of the title 

Sets the width of the FormCell’s title field to width 

Returns the width of the title, constrained to aSize 

Returns the width of the title 


Returns whether the FormCell is opaque 
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Displaying 


- drawlnside: (const NXRect *)cellFrame Draws the editable text portion of the cell 

in\iew icontrolView 

- drawSelf: (const NXRect *)cellFrame Draws the entire FormCell 

inVievr.controlView 

Managing Cursor Rectangles 

- resetCursorRect: (const NXRect *)cellFrame Resets the cursor rectangle so that the cursor becomes an 

inVievr.controlView I-beam when over the editable portion of the FormCell 


Tracking the Mouse 

- (BOOL)trackMouse:(NXEvent*)event Overrides Cell’s method to allow editing 

inRect: (const NXRect *)aRect 
ofView :controlView 

Archiving 

- read:(NXTypedStream *)stream Reads the FormCell from stream 

- write:(NXTypedStream *)stream Writes the FormCell to stream 


Listener 

Inherits From: Object 

Initializing the Class 

+ initialize Sets up a table of understood messages 

Initializing a New Listener Instance 

- init Initializes the Listener after it’s allocated 


Freeing a Listener 

-free 


Deallocates the Listener and its ports 
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Setting Up a Listener 

- addPort 

- removePort 

- (int)checklnAs:(const char *)name 

- (int)usePrivatePort 

- (int)checkOut 

- (port_t)listenPort 

- (port_t)signaturePort 

- (const char *)portName 

- setPriority:(int)/<?ve/ 

- (int)priority 

- setTimeout:(int)m^ 

- (int)timeout 
+ run 

Providing for Program Control 

- (int)msgCalc:(int *)flag 

- (int)msgCopyAsType:(const char *)aType 

ok:(int *)flag 

- (int)msgCutAsType:(const char *)aType 

ok:(int *)flag 

- (int)msgDirectory.(char *const *)fullPath 

ok:(int *)flag 

- (int)msgFile:(char *const *)fullPath 

ok:(int *)flag 

- (int)msgPaste:(int *)flag 

- (int)msgPosition:(char *const *)aString 

posType:(int *)anlnt 
ok:(int *)flag 

- (int)msgPrint:(const char *)fullPath 

ok:(int *)flag 

- (int)msgQuit:(int *)flag 

- (int)msgSelection:(char *const *)bytes 

length:(int *)numBytes 
asType:(const char *)aType 
ok:(int *)flag 


Sets procedure to receive messages at port 
Removes procedure that receives messages 
Allocates a port and registers it as name 
Allocates a port but doesn’t register it 
Unregisters the port, making it private 
Returns the Listener’s port 
Returns the port used to validate the Listener 
Returns registered name of the Listener’s port 
Sets the priority for receiving messages to level 
Returns priority level for receiving messages 
Sets how long to wait on sending reply 
Returns how long to wait on sending reply 
Enables Listener in absence of an Application object 


Receives message to update the current window 
Receives message to copy the selection 

Receives message to cut selection as aType data 

Receives message asking for the current directory 

Receives message asking for the current document 

Receives message to paste data from pasteboard 
Receives message requesting selection information 

Receives message to print the fullPath file 

Receives a remote message to quit 

Receives message requesting the current selection 
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Receives message to scroll so aString is visible 


- (int)msgSetPosition:(const char *)aString 

posiype:(int )anlnt 
andSe\ect:(int)selectFlag 
ok:(int *)flag 

- (int)msg Version: (char *const *)aString Receives message requesting version information 

ok:(int *)flag 

Receiving Remote Messages 

- messageReceived:(NXMessage *)msg Receives messages at the Listener’s port 

- (int)performRemoteMethod:(NXRemoteMethod *)method 

paramList:(NXParamValue *)params Performs Listener’s remote method 

- (NXRemoteMethod *)remoteMethodFor:(SEL)a5e/ector 

Looks up remote method for aSelector 

Assigning a Delegate 

- setDelegateumObject 

- delegate 

- setServicesDelegate:anC%'ect 

- servicesDelegate 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Matrix 

Inherits From: Control: View : Responder : Object 

Initializing the Matrix Class 

+ initialize Initializes the Matrix class 

+ setCe\\Class:classId Sets the default class used to make Cells 


Reads the Listener from stream 
Writes the Listener to stream 


Makes anObject the Listener’s delegate 
Returns the Listener’s delegate 
Makes anObject the receiver of service requests 
Returns the object that receives service requests 
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Initializing and Freeing a Matrix 

- initFrame: (const NXRect *)frameRect 

- initFrame:(const NXRect *)frameRect 

mode:(int )aMode 
ce\\Class:classId 
numRows: (int )numRows 
imn\Co\s:(int)numCols 

- initFrame:(const NXRect *)frameRect 

mode: (int )aMode 
prototype:aCe// 
numRo ws: ( mt)numRows 
numCoIs:(int)Ai«/nCo/5 

-free 

Setting the Selection Mode 

- setMode:(int )aMode 

- (int)mode 

Configuring the Matrix 

- setEnabled:(BOOL)/?flg 
-setEmptySelectionEnabled:(BOOL)/7ag 

- (BOOL)isEmptySelectionEnabled 

- setSelectionByRect:(BOOL)/7ag 

- (BOOL)isSelectionByRect 

Setting the Cell class 

- setCellClassic/aw/G? 

- setPrototype:aCe// 

- prototype 

Laying Out the Matrix 

- addCol 

- addRow 

- insertColAt:(int)co/ 

- insertRowAt:(int)row 


Initializes a new Matrix object in frameRect 

Initializes a new Matrix object in frameRect, 
with aMode as the selection mode, 
classld as the class used to make new Cells, 
and having numRows rows 
and numCols columns 

Initializes a new Matrix object with the given values 
with aMode as the selection mode, 
aCell as the prototype copied to make new Cells, 
and having numRows rows 
and numCols columns 

Deallocates the Matrix and all its Cells 


Sets the selection mode of the Matrix 
Returns the selection mode of the Matrix 


Sets whether the Matrix reacts to events 
Sets whether there may be no Cells selected 
Returns whether there may be no Cells selected 
Sets whether a user can drag a rectangular selection 
(the default is YES) 

Returns whether a user can drag a rectangular selection 


Sets the subclass of Cell used to make new Cells 
Sets the prototype Cell copied to make new Cells 
Returns the prototype Cell copied to make new Cells 


Adds a new column of Cells to the bottom of the Matrix 
Adds a new row of Cells to the right of the Matrix 

Inserts a new column of Cells at col, creating as many as 
needed to make the Matrix col columns wide 

Inserts a new row of Cells at row, creating as many as 
needed to make the Matrix row rows wide 
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- removeCol At: (int)co/ andFree:(BOOL)/7<2g 

- removeRo wAt: (int)rovv andF ree : (B OOL)flag 

- makeCeIlAt:(int)raw :(int)co/ 

- putCell inewCell at:(int)ravv :(int)co/ 

- renewRows:(int)«ew/?owj cols:(int )newCols 

- setCellSize:(const NXSize *)aSize 

- getCellSize:(NXSize *)theSize 

- getCellFrame:(NXRect *)theRect 

at:(int )row 
:(int )col 

- setIntercell:(const NXSize *)aSize 

- getIntercell:(NXSize *)theSize 

- (int)cellCount 

- getNumRows:(int *)rowCount 

numCoIs:(int *)colCount 

Finding Matrix Coordinates 

- getRow:(int *)row 

andCol:(int *)col 
ofCell: aCell 

- getRow:(int *)row 

andCol:(int *)col 

forPoint:(const NXPoint *)aPoint 

Modifying Individual Cells 

- setTcon:(const char *)iconNcime 

at:(int )row 
:(int )col 

- setState:(int)vfl/we at:(int)raiv :(int)co/ 

- setTitle:(const char *)aString at:(int)row :(int)co/ 

- setTag:(int )anlnt at:(int)raw :(int)co/ 

- setTag:(int)an//it 

target: anObject 
action:(SEL)aSWector 
at:(int)row 
:(int)co/ 


Removes the column at col , freeing the Cells if flag is YES 
Removes the row at row, freeing the Cells if flag is YES 
Creates a new Cell at row, col in the Matrix and returns it 
Replaces Cell at row and col with newCeli, returns old Cell 

Changes the number of rows and columns in Matrix 
without freeing any Cells 

Sets the width and height of all Cells in the Matrix 
Gets the width and height of Cells in the Matrix 
Returns the frame of the Cell at row and col 

Sets the vertical and horizontal spacing between Cells 
Gets the vertical and horizontal spacing between Cells 
Returns the number of Cells in the Matrix 
Gets the number of rows and columns in the Matrix 


Gets the row and col position of aCell 

Gets the row and col position corresponding to aPoint, and 
returns the Cell at that point 


Sets the icon for the Cell at row and col to the NXImage 
named iconName 

Sets the state of the Cell at row and col to value 

Assigns Cell at row and col the title aString 
Assigns the Cell at row and col the tag anlnt 
Assigns a tag, target, and action to the specified Cell 
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Selecting Cells 

- selectCel haCeli 

- selectCellAt:(int)wiv :(int)co/ 

- selectCellWithTag:(int)fln/«f 

- setSelectionFrom:(int)starrPo.s 

to:(int )endPos 
anchor:(int)anchorPos 
lit: (BOOL )flag 

- st\eotA\\:sender 

- selectedCell 

- getSelectedCells:(List *)aList 

- (int)selectedCol 

- (int)selectedRow 

- clearSelectedCell 

Finding Cells 

- findCellWithTag:(int)an/nf 

- cellAt:(int)rovv :(int)co/ 

- cellList 

Modifying Graphic Attributes 

- setBackgroundColor:(NXColor)tfCo/o/' 

- (NXColor)backgroundColor 

- setBackgroundGray:(float)vfl/we 

- (float)backgroundGray 

- setCellBackgroundColor:(NXColor)aCo/or 

- (NXColor)cellBackgroundColor 

- setCellBackgroundGray: (float) va/we 

- (float)cellBackgroundGray 

- setBackgroundTransparent: (BOOL )flag 

- (BOOL)isBackgroundTransparent 

- setCellBackgroundTransparent: (B OOh)flag 

- (BOOL)isCellBackgroundTransparent 

- setFonUfontObject 

- font 


Selects the Cell aCell if it is in the Matrix 
Selects the Cell at row and col 
Selects the Cell with the tag anlnt 
Selects the Cells in the Matrix from startPos to endPos, 
counting in row order from the upper left, as though 
anchorPos were the number of the last Cell selected, 
and highlighting the Cells according to flag 

Selects all the Cells in the Matrix 

Returns the last (lowest and rightmost) selected Cell 

Puts the selected Cells into aList 

Returns the column of the selected Cell 

Returns the row of the selected Cell 

Deselects the selected Cell 


Returns the Cell with anlnt as its tag 
Returns the Cell at row row and column col 
Returns the Matrix’s List of Cells 


Sets the color of the background between Cells to aColor 
Returns the color of the background between Cells 
Sets the gray of the background between Cells to value 
Returns the gray of the background between Cells 
Sets the color of the background within Cells to aColor 
Returns the color of the background within Cells 
Sets the gray of the background within Cells to value 
Returns the gray of the background within Cells 
Sets whether the background between Cells is transparent 

Returns whether the background between Cells is 
transparent 

Sets whether the background within Cells is transparent 
Returns whether the background within Cells is transparent 
Sets the Font used to display text in the Cells 
Returns the Font used to display text in the Cells 
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Editing Text in Cells 

- selectText '.sender Selects the text in the first or last editable Cell 

- selectTextAt:(int)rmv :(int)co/ Selects the text of the Cell at row, col in the Matrix 


Setting Tab Key Behavior 

- setNextText :anObject Sets the object selected when the user hits Tab while 

editing the last text Cell 

- setPreviousText:an(9&/ec/ Sets the object selected when user hits Shift-Tab while 

editing the first text Cell 


Assigning a Text Delegate 

- setTexiDe\egate:anObject Sets the delegate for messages from the field editor 

- textDelegate Returns the delegate for messages from the field editor 


Text Object Delegate Methods 

- (BOOL)textWillChange:text0fc/ecr 

- texiDidChangeuextObject 

- textDidGetKeys: textObject 

isEmpty: (BOOL )flag 

- (BOOL)textWillEnd:texfO&/'ect 

- textDidEnd: textObject 

endChar:(unsigned short)whyEnd 

Resizing the Matrix and Cells 

- setAutosizeCells:(BOOL)flag 

- (BOOL)doesAutosizeCells 

- calcSize 

- sizeTo:(float)wififr/i :(float )height 

- sizeToCells 

- sizeToFit 

- validateSize:(BOOL)/?ag 


Responds to a message from the field editor (see Text) 
Responds to a message from the field editor (see Text) 
Responds to a message from the field editor (see Text) 

Responds to a message from the field editor (see Text) 
Responds to a message from the field editor (see Text) 


Sets whether the Matrix resizes its Cells automatically 

Returns whether the Matrix resizes its Cells automatically 

Calculates Cell sizes 

Resizes the Matrix to width and height 

Resizes the Matrix to fit its Cells exactly 

Resizes the Cells and Matrix to fit the Cell contents 

Sets whether the Cell size needs to be recalculated 
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Scrolling 

- setAutoScroll:(BOOL)/?< 2 g 

- setScrollable:(BOOL)/fag 

- scrollCellToVisible:(int)raw :(int)co/ 

Displaying 

- display 

- drawSelf:(const NXRect *)rects :(int )rectCount 

- drawCel V.aCell 

- drawCellAt:(int)row :(int)co/ 

- drawCelllnsid e:aCell 

- highlightCellAt:(int)ww :(int)co/ \it:(BOOL)flag 

Target and Action 

- setTarget lanObject 

- target 

- set Action: (SELjaSe/ector 

- (SEL)action 

- setDouble Action: (SEL)aSelector 

- (SEL)doubleAction 

- setErrorAction:(SEL)aSe/ector 

- (SEL)error Action 

- setTarget lanObject at:(int)ravv :(int)co/ 

- setAction:(SEL)fl5e/ec/or at:(int)roiv :(int)co/ 

- sendAction 

- sendAction: (SEL)theAction Uv.theTarget 

- sendAction:(SEL)fl5e/ector 

to lanObject 

forAllCells:(BOOL )flag 

- sendDoubleAction 

- setReaction: (B OOL)//ag 


Sets whether the Matrix automatically scrolls when 
dragged in 

Makes all the Cells scrollable 

Scrolls Matrix so the Cell at row and col is visible 


Draws the Matrix and its Cells 

Draws the Matrix and its Cells 

Draws aCell if it’s in the Matrix 

Displays the Cell at row and col 

Draws the inside of aCell if it’s in the Matrix 

Highlights (or unhighlights) the Cell at row, col 


Sets the target of the Matrix to anObject 
Returns the target of the Matrix 
Sets the action of the Matrix to aSelector 
Returns the action of the Matrix 

Sets the action method used on double-clicks to aSelector 
Returns the action method for double clicks 
Sets the action method for editing errors to aSelector 
Returns the action method for editing errors 
Assigns anObject as the target of the Cell at row, col 

Assigns aSelector as the action method of the Cell at 
row, col 

Sends the selected Cell’s action, or the Matrix’s action if 
the Cell doesn’t have one 

Has the Application object send theAction to anObject 
Sends aSelector to anObject, for all Cells if flag is YES 

Sends the action corresponding to a double-click 
Sets whether sending an action clears the selection 
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Handling Event and Action Messages 


- (BOOL)acceptsFirstMouse Returns NO only if mode is NX_LISTMODE 

- mouseDown:(NXEvent *)theEvent Responds to a mouse-down event 

- (int)mouseDownFlags Returns the event flags in effect at start of tracking 

- (BOOL)performKeyEquivalent:(NXEvent *)theEvent 

Simulates mouse click in the appropriate Cell 


Managing the Cursor 

- resetCursorRects Resets cursor rectangles so that the cursor becomes an 

I-beam over text Cells 


Archiving 

- read:(NXTypedStream *).stream Reads the Matrix from stream 

- write:(NXTypedStream *)stream Writes the Matrix to stream 


Menu 


Inherits From: Panel: Window : Responder : Object 


Creating a Menu Zone 

+ setMenuZone:(NXZone *)zone Sets the zone from which Menus should be allocated 

+ (NXZone *)menuZone Returns the zone from which Menus should be allocated, 

creating one if necessary 


Initializing a New Menu 

- init Initializes a new Menu with the title “Menu” 

- initTitle: (const char *)aTitle Initializes a new Menu with aTitle as its title 
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Setting Up the Menu Commands 

- addItem:(const char *)aString 

action: (SEL)aSe/ector 
keyEquivalent:(unsigned short )charCode 

- setltemList:aMotrix 

- itemList 

Finding Menu Items 

- findCellWithTag:(int)a7hg 

Building Submenus 

- setSubmenu :aMenw forltemraCe// 

- submenuAction:.swz£fer 

Managing Menu Windows 

- moveTopLeftTo:(NXCoord)jc :(NXCoord)y 

- windowMoved:(NXEvent *)theEvent 

- getLocation:(NXPoint *)theLocation 

forSubmenu laSubmenu 

- sizeToFit 

- close 

Displaying the Menu 

- display 

- setAutoupdate:(BOOL)//ag 

- update 

Handling Events 

- mouseDown:(NXEvent *)theEvent 

- rightMouseDown:(NXEvent *)theEvent 

Archiving 

- read:(NXTypedStream *) stream 

- write:(NXTypedStream *)stream 

- awake 


Adds a new item to the end of the Menu 

Replaces the current Matrix of items with aMatrix 
Returns the Menu’s Matrix of MenuCell items 


Returns the MenuCell that has aTag as its tag 


Makes aMenu a submenu controlled by aCell 
Activates a submenu attached to sender 's Menu 


Moves the Menu’s top left comer to x, y 
Handles a submenu being tom off its supermenu 
Determines where to display an attached submenu 
when it’s brought up 

Resizes the Menu to exactly fit the command items 
Removes the Menu (and any submenus) from the screen 


Displays the Menu, resizing if needed 
Sets whether Menu reacts to update messages 
Updates each MenuCell item 


Tracks the cursor in the Menu and submenus 
Pops the main menu up under the cursor 


Reads the Menu from stream 
Writes the Menu to stream 
Reinitializes a Menu as it’s unarchived 


Classes: Menu 


2-43 



MenuCell 


Inherits From: ButtonCell: ActionCell: Cell: Object 

Initializing a New MenuCell 
-init 

- initTextCell:(const char *)aString 

Setting the Update Action 

- setUpdateAction:(SEL)flSe/ector 

{orMenuiaMenu 

- (SEL)updateAction 

Checking for a Submenu 

- (BOOL)hasSubmenu Returns whether the MenuCell has a submenu 

Tracking the Mouse 

- (BOOL)trackMouse:(NXEvent *)theEvent Refers mouse tracking to the MenuCell’s Menu 

inRect:(const NXRect *)cellFrame 
ofView :controlView 

Setting User Key Equivalents 

+ useUserKeyEquivalents:(BOOL]/?ag Sets the class to apply user-assigned key equivalents 

- (unsigned short)userKeyEquivalent Returns the user-assigned key equivalent for the MenuCell 

Archiving 

- read:(NXTypedStream *)stream Reads the MenuCell from stream 

- write:(NXTypedStream *)stream Writes the MenuCell to stream 


Sets the update action for the MenuCell to aSelector, 
and sets aMenu to auto-update 

Returns the update action for the MenuCell 


Initializes a new MenuCell with “Menu Item” as its title 
Initializes a new MenuCell with aString as its title 
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NXBitmapImageRep 


Inherits From: NXImageRep : Object 


Initializing a New NXBitmapImageRep object 

- initFromSection:(const char *)name 

- initFromFile:(const char *) filename 

- initFromStream:(NXStream *)stream 

- initData:(unsigned char *)data 

fromRect:(const NXRect *)rect 

- initData:(unsigned char *)data 

pixelsWide:(int )width 
pixelsHigh:(int)/^/g/n 
bitsPerSample:(int)b/w 
samplesPerPixel: (int)5/?p 
hasAlpha:(BOOL)<a/p/za 
is Planar :(BOOL)co/z/z£ 
colorSpace:(NXColorSpace)57?ace 
bytesPerRow:(int)row#ytes 
bitsPerPixel: (int)pixelBits 

- initDataPlanes: (unsigned char **)planes 

pixels Wide: (int )width 
pixelsHigh: (int)height 
bitsPerSample:(int)fr/« 
samplesPerPixel: (int)sp/? 
hasAlpha:(BOOL)a/p/za 
isPlanar:(BOOL)con/zg 
colorSpace: (NXColorSpacejspace 
bytesPerRow: (int)rowBytes 
bitsPerPixel: (int )pixelBits 

Creating a List of NXBitmapImageReps 

+ (List *)newListFromSection:(const char *)name 

+ (List *)newListFromSection:(const char *)name 
zone:(NXZone *)aZone 

+ (List *)newListFromFile:(const char *) filename 

+ (List *)newListFromFile:(const char *) filename 
zone:(NXZone *)aZone 


Initializes the new object from TIFF data in the section 
Initializes the new object from TIFF data in filename 
Initializes the new object from TIFF data in stream 
Initializes the new object using data read from an image 

Initializes the new object from raw bitmap data 


Initializes the new object from raw bitmap data in the 
planes data buffers 


Returns a List of NXBitmapImageReps from name data 

Returns a List of NXBitmapImageReps from name data 
Returns a List of NXBitmapImageReps from filename 
Returns a List of NXBitmapImageReps from filename 


Classes: NXBitmapImageRep 2-45 



+ (List *)newListFromStream:(NXStream *)stream 


+ (List *)newListFromStream:(NXStream *)stream 
zone:(NXZone *)aZone 

Reading Information from a Rendered Image 

+ (int)sizeImage:(const NXRect *)rect 

+ (int)sizelmage:(const NXRect *)rect 
pixels Wide: (int *)width 
pixelsHigh:(int *)height 
bitsPerSample:(int *)bps 
samplesPerPixel:(int *)spp 
hasAlpha:(BOOL *)alpha 
isPlanar:(BOOL *)config 
colorSpace:(NXColorSpace *)space 

Copying and Freeing an IMXBitmapimageRep 

- copyFromZone:(NXZone *)zone 

-free 

Getting Information about the Image 

- (int)bitsPerPixel 

- (int)sampIesPerPixel 

- (BOOL)isPlanar 

- (int)numPlanes 

- (int)bytesPerPlane 

- (int)bytesPerRow 

- (NXColorSpace)colorSpace 

Getting Image Data 

- (unsigned char *)data 

- getDataPlanes:(unsigned char *)planes 

Drawing the Image 

- (BOOL)draw 

- (BOOL)drawin:(const NXRect *)rect 


Returns a List of NXBitmapImageReps from stream data 
Returns a List of NXBitmapImageReps from stream data 


Returns the number of bytes in bitmap for the rect image 
Provides information about the image bounded by the rect 
rectangle 


Returns a copy of the NXBitmapImageRep 
Deallocates the NXBitmapImageRep 


Returns how many bits are needed to specify one pixel 
Returns the number of samples (components) in the data 
Returns YES if in planar configuration, NO if meshed 
Returns the number of data planes 
Returns the number of bytes in each data plane 
Returns the number of bytes in a scan line 
Returns how bitmap data is to be interpreted 


Returns a pointer to the bitmap data 
Provides pointers to each plane of bitmap data 


Draws the image at (0.0, 0.0) in current coordinates 
Modifies coordinates so image is drawn in rect rectangle 
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Producing a TIFF Representation of the image 

- writeTIFF:(NXStream *)stream 

- writeTIFF:(NXStream *)stream 

\isingCompression:(int)compression 

- writeTIFF:(NXStream *)stream 

usingCompression:(int)com/)re^'on 

andFactor:(float)/actor 


Writes a TIFF representation of the image to stream 
Writes a TIFF representation of the image to stream 

Writes a TIFF representation of the image to stream 


Setting and Checking Compression Types 

+ (void)getTIFFCompressionTypes:(const int **)list 

count:(int *)numTypes Returns all available compression types 

+ (const char *)localizedNameForTIFFCompressionType:(int)compre55/on 


- (BOOL)canBeCompressedUsing:(int)com/?re.s\s70tt 

- (void)getCompression:(int *) compression 

andFactor:(float *)factor 

- ( void)setCompression:(int)compression 

andFactor: (f[oa.t)factor 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Returns the localized name for the compression type 

YES if the image can be compressed using compression 
Returns the compression type and compression factor 

Sets the compression type and compression factor 

Reads the NXBitmapImageRep from stream 
Writes the NXBitmapImageRep to stream 


NXBrowser 

Inherits From: Control: View : Responder : Object 

Initializing and Freeing an NXBrowser 

- initFrame:(const NXRect *)frameRect Initializes a new NXBrowser within frameRect 

- free Frees the NXBrowser and its Matrices, NXBrowserCells 

and other objects (but not the delegate) 
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Setting the Delegate 

- setDelegat eianObject 

- delegate 

Target and Action 

- setAction:(SEL)aSWecfor 

- (SEL)action 

- setTarget :anObject 

- target 

- setDoubleAction:(SEL)a£e/ectar 

- (SEL)doubleAction 

Setting Component Classes 

- setMatrixClass:c/<m/<i 

- setCellClass iclassld 

- setCellPrototyperaCe// 

- cellPrototype 

Setting NXBrowser Behavior 

- setMultipleSelectionEnabled: (B OOL )flag 

- (BOOL)isMuItipleSelectionEnabled 

- setBranchSelectionEnabled: (BOOL)flag 

- (BOOL)isBranchSelectionEnabled 

- setEmptySelectionEnabled: (BOOL )flag 

- (BOOL)isEmptySelectionEnabled 

- reuseCo!umns:(BOOL)/7ag 

- setEnabled: (BOOL)flag 

- (BOOL)acceptsFirstResponder 

- accept ArrowKeys:(BOOL)acceptFlag 

andSendActionMessages:(BOOL)sen^F/ag 

- getTitleFromPreviousCoIumn: (BOOL )flag 


Sets the NXBrowser’s delegate to anObject 
Returns the NXBrowser’s delegate 


Sets the NXBrowser’s action method to aSelector 

Returns the NXBrowser’s action method 

Sets the NXBrowser’s target object to anObject 

Returns the NXBrowser’s target object 

Sets the NXBrowser’s double-click action to aSelector 

Returns the NXBrowser’s double-click action method 


Sets the class of Matrix used in the NXBrowser’s columns 
Sets the class of Cell used in the columns of NXBrowser 

Sets the Cell instance copied to display items in the 
columns of NXBrowser 

Returns the NXBrowser’s prototype Cell 


Sets whether the user can select multiple items 

Returns whether the user can select multiple items 

Sets whether the user can select branch items when 
multiple selection is enabled 

Returns whether the user can select branch items when 
multiple selection is enabled 

Sets whether there can be nothing selected 

Returns whether there can be nothing selected 

Prevents Matrices from being freed when their columns are 
unloaded, so they can be reused 

Sets whether the NXBrowser reacts to events 

Enables arrow keys for scrolling and sending action 
messages 

Sets whether the title of a column is set to the title of the 
selected Cell in the previous column 
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Configuring Controls 

- useScrollBars:(BOOL)/fog 

- useScrollButtons:(BOOL)/fag 

- setHorizontalScrollButtonsEnabled: (BOOL )flag 

- (BOOL)areHorizontalScrollButtonsEnabled 

- setHorizontalScrollerEnabled: (BOOL )flag 

- (B OOL)isHorizontalScollerEnabled 

Setting the NXBrowser's Appearance 

-setMinColumn\Vidth:(int)columnWidth 

- (int)minColumnWidth 

- setMax\isibleColumns:(mt)colwnnCount 

- (int)maxVisibleColumns 

- (int)numVisibleColumns 

- (int)firstVisibleColumn 

- (int)lastVisibleCoIumn 

- (int)lastColumn 

- separateColumns:(BOOL)/fag 

- (BOOL)columnsAreSeparated 

Manipulating Columns 

- loadColumnZero 

- (BOOL)isLoaded 

- addColumn 

- reloadColumn:(int)c 0 /wmn 

- display Column: {mt)column 

- displayAllColumns 

- setLastColumn:(int)co/M/?m 

- selectAll ‘.sender 

- (int)selectedColumn 

- (int)columnOf:/nurra: 

- validateVisibleColumns 


Sets whether Scrollers are used to scroll columns 
Sets whether buttons are used to scroll columns 
Sets whether buttons are used to scroll horizontally 
Returns whether buttons are used to scroll horizontally 
Sets whether Scroller is used to scroll horizontally 
Returns whether Scroller is used to scroll horizontally 


Sets the minimum column width 

Returns the minimum column width 

Sets the maximum number of columns displayed 

Returns the maximum number of visible columns 

Returns the number of columns visible 

Returns the index of the first visible column 

Returns the index of the last visible column 

Returns the index of the last column loaded 

Sets whether to separate columns with bezeled borders 

Returns whether columns are separated by bezeled borders 


Loads column zero; unloads previously loaded columns 
Returns whether column zero is loaded 
Adds a column to the right of the last column 
Reloads column if it is loaded; sets it as the last column 
Updates to display columns through index column 
Updates the NXBrowser to display all loaded columns 
Sets the last column to column 
Selects all Cells in the last column of the NXBrowser 
Returns the index of the last column with a selected item 
Returns the column number in which matrix is located 
Invokes delegate method browsericolumnls Valid: for 
visible columns 
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Manipulating Column Titles 

- setTitled:(BOOL)/fag 

- (BOOL)isTitled 

- setTitle: (const char *)aString 

ofColumn: (int )column 

- (const char *)titIeOfColumn:(int)a?/Mmrc 

- (NXRect *)getTitleFrame:(NXRect *)theRect 

ofColumn: (int )column 

- (NXCoord)titleHeight 

- drawTitle:(const char *)title 

inRect:(const NXRect *)aRect 
ofColumn: (int )column 

- clearTitlelnRect:(const NXRect *)aRect 

ofColumn: (int) column 

Scrolling an NXBrowser 

- scroIIColumnsLeftBy:(int)i7z//MmoMnt 

- scrollColumnsRightBy:(int),s7»yh4m0W72t 

- scrollColumnTo Visible: (int )column 

- scrollUpOrDownrsender 

- scrollViaScroller:^c«c?er 

- reflectScroll:c//pV?ew 

- updateScroller 

Event Handling 

- mouseDown:(NXEvent *)theEvent 

- keyDown:(NXEvent *)theEvent 

- doC\ick:sender 

- doDoubIeCIick:serc der 

Getting Matrices and Ceils 

- getLoadedCelIAtRow:(int)raw 

inColumn: (int )column 

- matrixInColumn:(int)co/n/nn 

- selectedCell 

- getSelectedCells:aZisf 


Sets whether columns display titles 

Returns whether columns display titles 

Sets the title of the column at index column to aString 

Returns the title displayed for the column at index column 

Returns the bounds of the title frame for the column at 
index column 

Returns the height of column titles 

Draws the title for the column at index column 

Clears the title for the column at index column 


Scrolls columns left by shiftAmount columns 

Scrolls columns right by shiftAmount columns 

Scrolls to make the column at index column visible 

Scrolls a column up or down 

Scrolls columns left or right based on a Scroller 

Updates scroll buttons to reflect column contents 

Updates the horizontal Scroller to reflect column positions 


Handles mouse-down events in the NXBrowser 
Handles key-down events 

Responds to mouse clicks in a column of NXBrowser 
Responds to double-clicks in a column of NXBrowser 


Loads if necessary and returns the Cell at row in column 

Returns the matrix located in column 

Returns the last selected Cell (rightmost and lowest) 

Returns in aList all the rightmost selected Cells 
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Getting Column Frames 

- (NXRect *)getFrame:(NXRect *)theRect 

ofColumn:(int)co/wm/i 

- (NXRect *)getFrame:(NXRect *)theRect . 

of!nsideOfColumn:(int)co/i/m/i 

Manipulating Paths 

- setPathSeparator:(unsigned short )charCode 

- setPath: (const char *)path 

- (char *)getPath:(char *)tliePath 

toColumn:(int)co/wm/i 

Drawing 

- drawSelf:(const NXRect *)rects :(int )rectCount 

Resizing the NXBrowser 

- sizeTo:(NXCoord)vv/Wt/i :(NXCoord )height 

- sizeToFit 

Arranging an NXBrowser's Components 
-tile 

Methods Implemented by the Delegate 

- (BOOL)browser: sender 

columnls Valid: (int )column 

- browserDidScrolhsercder 

- (intjbrowserrsem/er 

fillMatrix:mafra 
inColumn:(int )column 

- (int)browser:sender 

getNumRowsInColumn:(int ^column 

- browser '.sender 

loadCell '.cell 
atRow:(int)row 
inColumn:(int )column 

- (BOOL)browser:sencfer 

selectCell:(const char *)title 
inColumn:(int )column 


Returns the rectangle containing the column at index 
column 

Returns the rectangle containing the column at index 
column, not includingborders 


Sets the path separator to charCode 

Parses path and selects corresponding items in columns 

Returns string representing path from the first 
column to the column at index column 


Draws the NXBrowser 


Resizes the NXBrowser to width and height 
Resizes the NXBrowser to fit all its contents 


Adjusts the NXBrowser’s components 


Returns whether the contents of the column are valid 

Notifies the delegate when the NXBrowser has scrolled 
Returns the number of rows in a column and loads 
NXBrowserCells in matrix 

Returns the number of rows of data in the column at index 
column 

Requests the delegate to load Cell at row in the column at 
index column 


Requests the delegate to select the Cell with title title in the 
column at index column 
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- (const char *)browser '.sender 

titleOfColumn:(int)co/nmn 

- browserWillScroll:^/zJer 


Queries the delegate for the title to display above the 
column at index column 

Notifies the delegate when the NXBrowser will scroll 


IMXBro wserCel I 


Inherits From: Cell: Object 

Initializing a NXBrowserCell 

- init Initializes a new NXBrowserCell with “Browserltem” as 

its title 

- initTextCell: (const char *)aString Initializes a newNXBrowserCell with aString as its title 


Determining Component Sizes 

- calcCellSize:(NXSize *)theSize 

inRect: (const NXRect *)aRect 

Accessing Graphic Attributes 

- (BOOL)isOpaque 
+ branchlcon 

+ branchlconH 

Displaying 

- drawlnside: (const NXRect *)cellFrame 

inView '.aView 

- drawSelf: (const NXRect *)cellFrame 

inView:aV7evv 

- highlight: (const NXRect *)cellFrame 

in Viewer V/evv lit:(BOOL)/ir 

Placing in Browser Hierarchy 

- setLeaf:(BOOL)/?ag 

- (BOOL)isLeaf 


Calculates the size of the NXBrowserCell within aRect 


Returns YES, since an NXBrowserCell is opaque 
Returns the NXImage for branch NXBrowserCells 
Returns the NXImage for highlighted branches 

Draws the inside of the NXBrowserCell in aView 

Draws the entire NXBrowserCell in aView 

If lit is YES, highlights the NXBrowserCell in aView 

Sets whether the NXBrowserCell is a leaf or a branch 
Returns whether the NXBrowserCell is a leaf or a branch 
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Determining Loaded Status 

- setLoaded:(BOOL)/fog Sets whether the NXBrowserCell is loaded and displayble 

- (BOOL)isLoaded Returns whether the NXBrowserCell is loaded 

Setting State 

- set Highlights the NXBrowserCell and sets its state to 1 

- reset Unhighlights the NXBrowserCell and sets its state to 0 


NXCachedlmageRep 

Inherits From: NXImageRep : Object 

Initializing a New NXCachedlmageRep 

- initFromWindow:(Window *)aWindow 

rect:(const NXRect *)aRect 

-copyFromZone:(NXZone *)theZone 

Freeing an NXCachedlmageRep 

-free 

Getting the Representation 

- getWindow:(Window **)theWindow 

andRect: (NXRect *)theRect 

Drawing the Image 

- (BOOL)draw 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Initializes the new NXCachedlmageRep for an image to 
be drawn in aWindow 

Creates and returns a copy of the receiver 


Deallocates the NXCachedlmageRep 


Provides the Window and rectangle where the image is 
cached 


Reads the cached image and renders it 


Reads the NXCachedlmageRep from stream 
Writes the NXCachedlmageRep to stream 
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NXColorPanel 


Inherits From: Panel: Window : Responder : Object 


Creating a New NXColorPanel 

+ newColorMaskrCintjco/ormasfc 

+ newContent:(const NXRect *)contentRect 
style: (int )aStyle 
backing:(int)bufferingType 
buttonMask: (int)ma sk 
defer:(BOOL )flag 

+ newContent:(const NXRect *)contentRect 
style: (in t)aStyle 
backing:(int)bufferingType 
buttonMask: (int )mask 
defer: (BOOL)/fag 
colorMask:(int )colormask 

+ sharedInstance:(BOOL)create 

Setting the NXColorPanel 

- (int)colorMask 

- setColorMask:(int)ce>/ 0 rmas£ 

- setContinuoiis:(BOOL)//<3g 

- setMode:(int)m<?<ie 

- setAccessoryViewmVfew 

- set Action: (SEL)aSelector 

- setShowAlpha:(BOOL)y/ag 

- setTarget :anObject 

Setting Color 

- color:(NXColor *)color 

- setColor:(NXColor)cc/c>r 

+ dragColor:(NXColor *)color 

withEvent:(NXEvent *)event 
from View '.SourceView 


Returns the shared NXColorPanel 
Returns the shared NXColorPanel 


Returns the shared NXColorPanel 


If YES, creates if necessary and returns the shared 
NXColorPanel 


Returns the color mask of the NXColorPanel 
Sets the color mask of the NXColorPanel 
Sets the NXColorPanel to continuously send the action 
message to the target 

Sets the mode and returns the NXColorPanel 
Sets the accessory view to aView 
Sets the action message sent to the target 
Sets the NXColorPanel to show alpha values 
Sets the target of the NXColorPanel 


Returns the currently selected color 
Sets the color of the NXColorPanel 
Drags color into a destination view from SourceView, 
event is usually an NX_MOUSEUP 
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NXColorPicker 


Inherits From: Object 

Conforms To: NXColorPickingDefault 

Initialization 

- initFromPickerMask:(int )theMask 

withCoIorPanel:t/iePane/ 

Button Images 

- provideNewButtonlmage 

- insertNewButtonlmagernevv/mage 

in: newButtonCell 


Initializes the receiver for the specified mask and 
color panel 


Returns a new button image for the color picker 
Override to customize newlmage before insertion 
in newButtonCell 


View Management 

- viewSizeChangedrserafer Does nothing. Override to respond to size change. 

Alpha Control Check 

- alphaControlAddedOrRemoved :sender Responds to change in color panel alpha control status 

Order of Button Appearance 

- (float)insertionOrder Returns the color picker button’s insertion order 

Using Color Lists 

- attachColorLishco/orL/sr 

- detachColorList:co/orL^r 

Mode 

- setMode:(int)morfe Override to set the color picker’s mode 


Override to attach a color list to a color picker 
Override to detach a color list from a color picker 
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NXColorWell 


Inherits From: Control: View: Responder: Object 


New 

- initFrame:(const NXRect *)theFrame 

Event Handling 

- (BOOL)acceptsFirstMouse 

- mouseDown:(NXEvent *)theEvent 

Drawing 

- drawSelf:(const NXRect *)rects 

:(int )rectCount 

- drawWellInside:(const NXRect *)insideRect 

Activating 

- deactivate 

+ deactivateAIlWells 

- activate :(int )exclusive 

- (BOOL)isActive 

- setEnabled:(BOOL)ena£>/c^ 

Managing Color 

- active WellsTakeColorFroirusender 

- activeWellsTakeCoIorFrom '.sender 

continuous :(BOOL)co7zt//u/o»5/v 

- (NXColor)color 

- takeColorFrom:^(?/7r/er 

- acceptColor:(NXColor)co/or 

atPoint:(NXPoint *)aPoint 

- setColor:(NXColor)co/ 0 r 

- updateCustomCoIorList 


Initializes and returns a new instance of NXColorWell 


Returns YES 

Responds to mouse down in the NXColorWell 


Draws the entire NXColorWell, including borders 

Draws the colored area inside the NXColorWell,without 
drawing borders 


Deactivates and returns the NXColorWell 
Deactivates all currently active NXColorWells 
Activates and returns the NXColorWell 
Returns YES if the NXColorWell is active 
Enables the NXColorWell 


Changes color of all active wells to that of sender 

Continuously changes color of all active, continuous 
wells to that of sender 

Returns the color of the NXColorPanel 
Changes color of the well to that of sender 

Changes color of the well to color when aPoint is a 
point in the bounds of the NXColorWell 

Sets the color of the well to color 

Saves the current color list in NX_COLORLISTMODE 
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Target and Action 

- (SEL)action 

- setAction:(SEL) aSelector 

- setTarget :anObject 

- target 

Archiving 

- awake Initializes the NXColorWell after unarchiving 


Returns the NXColorWell’s action message 
Sets the NXColorWell’s action message 
Sets the NXColorWell’s target 
Returns the NXColorWell’s target 


NXCursor 


Inherits From: Object 

Initializing a New NXCursor Object 
-init 

- initF romlmage: image 

Defining the Cursor 

- setlmag einewlmage 

- image 

- setHotSpot: (const NXPoint *)spot 

Setting the Cursor 

-push 
-pop 
+ pop 
-set 

- setOnMouseEntered:(BOOL)/?flg 

- setOnMouseExited:(BOOL)/fog 

- mouseEntered:(NXEvent *)theEvent 

- mouseExited:(NXEvent *)theEvent 

+ currentCursor 


Initializes a new NXCursor, but doesn’t set the image 
Initializes a new NXCursor object with image 


Sets the NXImage object that supplies the cursor image 
Returns the NXImage object that has the cursor image 
Sets the point on the cursor that’s aligned with the mouse 


Makes the NXCursor the current cursor 

Restores the previous cursor 

Restores the previous cursor 

Sets the NXCursor to be the current cursor 

Determines whether mouseEntered: sets cursor 

Determines whether mouseExited: sets cursor 

Responds to a mouse-entered event 

Responds to a mouse-exited event 

Returns the current cursor 
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Archiving 


- read:(NXTypedStream *)stream Reads the NXCursor from the typed stream stream 

- write:(NXTypedStream *)stream Writes the NXCursor to the typed steam stream 


NXCustomlmageRep 

Inherits From: NXImageRep : Object 

Initializing a New NXCustomlmageRep 

- initDrawMethod:(SEL)aSWe<:tor 

inObject xanObject 

Drawing the Image 

- (BOOL)draw 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Initializes the new object so that anObjecf s aSelector 
method will draw the image 


Sends a message to draw the image 


Reads the NXCustomlmageRep from stream 
Writes the NXCustomlmageRep to stream 


NXEPSImageRep 

Inherits From: NXImageRep : Object 


Initializes the new object from EPS code in the section 
Initializes the new object from EPS code in filename 
Initializes the new object from EPS code in stream 


Initializing a New NXEPSImageRep Instance 

- initFromSection:(const char *)name 

- initFromFile:(const char *)filename 

- initFromStream:(NXStream *)stream 
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Creating a List of NXEPSImageReps 

+ (List *)ne\vListFromSection:(const char *)name 

+ (List *)ne\vListFromSection:(const char *)name 
zone:(NXZone *)aZcme 

+ (List *)newListFromFile:(const char *) filename 

+ (List *)newListFromFile:(const char *) filename 
zone:(NXZone *)aZone 

+ (List *)newListFromStream:(NXStream *)stream 

+ (List *)newListFromStream:(NXStream *)stream 
zone:(NXZone *)aZone 

Copying and Freeing an NXEPSimageRep 

- copyFromZone:(NXZone *)zone 
-free 

Getting the Rectangle that Bounds the Image 

- getBoundingBox:(NXRect *)rect 

Getting Image Data 

- getEPS:(char **)theEPS length:(int *)numBytes 

Drawing the Image 

- prepareGState 

- (BOOL)draw 

- (BOOL)drawIn:(const NXRect *)rect 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Returns a List of NXEPSImageReps from EPS in name 

Returns a List of NXEPSImageReps from EPS in name 

Returns a List of NXEPSImageReps from filename data 
Returns a List of NXEPSImageReps from filename data 

Returns a List of NXEPSImageReps from EPS in stream 
Returns a List of NXEPSImageReps from EPS in stream 

Returns a copy of the NXEPSimageRep 
Deallocates the NXEPSimageRep 


Copies the EPS bounding box into the rect rectangle 


Provides a pointer to the EPS code 


Implemented by subclasses to prepare the graphics state 
Draws the image at (0.0, 0.0) in current coordinates 
Draws the image so it fits within the rect rectangle 


Reads the NXEPSimageRep from stream 
Writes the NXEPSimageRep to stream 
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NXHelpPanel 


Inherits From: Panel: Window : Responder : 

Initializing and Freeing 

+ new 

+ newForDirectory:(const char *)helpDirectory 

- addSupplement: (const char *)helpDirectory 

inPath:(const char *)supplementPath 

-free 

Attaching Help to Objects 

+ attachHelpFile: (const char *) filename 

markerName: (const char *)markerName 
to'.anObject 

+ detachHeIpFrom:a«<9&/ec? 

Setting Click-for-Help 

+ (BOOL)isClickForHelpEnabled 
+ setCIickForHelpEnabled: (BOOL )enabled 

Printing 

- \*r:\r\t:sender 

- printPanek-yeflifer 

Querying 

-(NXAtom)helpDirectory 
-(NXAtom) helpFile 

Showing Help 

- showFile: (const char *) filename 

atMarker: (const char *)markerName 

- (BOOL)showHelpAttachedTo:an0^ect 


Object 


Creates, if necessary, and returns the NXHelpPanel object 
Creates, if necessary, and returns the NXHelpPanel object 
Adds supplemental helpto the text displayed in the panel 

Frees the NXHelpPanel and its storage 


Associates the help file at markerName with anObject 

Removes any help information associated with anObject 


Returns whether the click-for-help feature is enabled 
Sets whether the click-for-help feature is enabled 


Prints the currently displayed help text 
Prints the currently displayed help text 


Returns the absolute path of the help directory 
Returns the path of the currently loaded help file 


Causes the Help panel to display the help contained in 
filename at markerName 

Causes the Help panel to display help attached to anObject 
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IMXImage 


Inherits From: Object 

Initializing a New NXImage Instance 
-init 

- initSize:(const NXSize *)aSize 

- initFromSection:(const char *)name 

- initFromFile:(const char *) filename 

- initFromPasteboard:(Pasteboard *) pasteboard 

- initFromStream:(NXStream *)stream 

- initFromImage:(NXImage *)image 

rect:(const NXRect *)rect 

- copyFromZone:(NXZone *)zone 

Freeing an NXImage object 
-free 

Setting the Size of the Image 

- setSize:(const NXSize *)aSize 

- getSize:(NXSize *)theSize 

Referring to Images by Name 

- (BOOL)setName:(const char *)string 

- (const char *)name 

+ findlmageNamed: (const char *)name 


Initializes the new NXImage without setting its size 
Initializes the new NXImage to the specified size 
Initializes the new object from the data in name section 
Initializes the new NXImage from the data in filename 
Initializes the new NXImage from the data in pasteboard 
Initializes the new NXImage from the data in stream 
Initializes the new NXImage to be a subimage of image 

Creates and returns a copy of the NXImage in zone 


Frees the NXImage and its representations 


Sets the size of the image in base coordinates 
Provides the size of the image 


Assigns string as the name of the NXImage object 
Returns the name of the NXImage object 
Returns the NXImage object with name 


Specifying the Image 

- (BOOL)useDrawMethodr(SEL )aSelector Creates a representation that will use a delegated method 

inObject :anObject to draw the image 

- (BOOL)useFromSection:(const char *)name Creates representations for the data in the name section 

- (BOOL)useFromFile:(const char *) filename Creates representations for the data in filename file 

- (BOOL)useRepresentation:(NXImageRep *)imageRep 

Adds imageRep to the List of representations 
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- (BOOL)useCacheWithDepth:(NXWindowDepth)de/?m 


- (BOOL)IoadFromStream:(NXStream *)stream 

- (BOOL)loadFromFile: (const char *)fileName 

- (BOOL)lockFocus 

- (BOOL)lockFocusOn:(NXImageRep *)imageRep 

- unlockFocus 

Using the Image 

- composite:(int)o/? 

toPoint: (const NXPoint *)aPoint 

- composite:(int)o/? 

fromRect: (const NXRect *)aRect 
toPoint: (const NXPoint *)aPoint 

- dissolve: (floa.t)delta 

toPoint:(const NXPoint *)aPoint 

- dissolve :(floai)delta 

fromRect: (const NXRect *)aRect 
toPoint:(const NXPoint *)aPoint 

Choosing Which Image Representation to Use 

- setColorMatchPreferred: (B OOL)flag 

- (BOOL)isColorMatchPreferred 

- setEPSUsedOnResolutionMismatch: (BOOL)flag 

- (B OOL)isEPSUsedOnResolutionMismatch 
-setMatchedOnMultipleResolution:(BOOL)/Z< 2 g 

- (B OOL)isMatchedOnMultipleResolution 

Getting the Representations 

- (NXImageRep *)lastRepresentation 

- (NXImageRep *)bestRepresentation 

- (List *)representationList 

- removeRepresentation: (NXImageRep *)imageRep 


Creates an empty representation to draw in 
Creates representation for the data read from stream 
Creates representation for the data read from filename 
Prepares for drawing in the best representation 
Prepares for drawing in imageRep 
Balances a previous lockFocus or lockFocusOn: 


Composites the image to aPoint 

Composites the aRect portion of the image to aPoint 

Composites the image using the dissolve operator 
Composites the image using the dissolve operator 


Determines whether color matches are preferred 
Returns whether color matches are preferred 

Sets whether to use EPS representations on mismatch 
Returns whether to use EPS representations on mismatch 
Sets whether resolution multiples match 
Returns whether resolution multiples match 


Returns the last representation added to the NXImage 
Returns the best representation for the deepest screen 
Returns the List of all the representations 

Removes imageRep from the List of representations 
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Determining How the Image is Stored 

- setUnique:(BOOL)/7ag 

- (BOOL)isUnique 

- setDataRetained:(BOOL)/?tfg 

- (BOOL)isDataRetained 

- setCacheDepthBounded:(BOOL)jffa# 

- (BOOL)isCacheDepthBounded 

-getImage:(NXImage **)image 
rect:(NXRect *)rect 

Determining How the Image is Drawn 

- setFlipped:(BOOL)/7ag 

- (BOOL)isFlipped 

- setScalable:(BOOL)//ag 

- (BOOL)isScalable 

- setBackgroundColor:(NXColor)aCo/or 

- (NXColor)backgroundColor 

- (BOOL)drawRepresentation:(NXImageRep 

inRect:(const NXRect *)rect 

- recache 

Assigning a Delegate 

- setDe\egate:anObject 

- delegate 

Producing TIFF Data for the Image 

- writeTIFF:(NXTypedStream *)stream 

- writeTIFF:(NXTypedStream *)stream 

allRepresentations : (BOOL )flag 

Managing NXImageRep subclasses 

+(void)registerImageRep : imageRepClass 
+ (void)unregisterlmageRep : imageRep Class 
+ (Class)imageRepForFileType:(const char *)type 


Sets whether representations are cached alone 
Returns whether representations are cached alone 
Sets whether image data is retained by the object 
Returns whether image data is retained 
Sets whether the default depth limit applies to caches 
Returns whether the default depth limit applies to caches 
Gets the image that the receiver is a subimage of 


Makes anObject the delegate of the NXImage 
Returns the delegate of the NXImage 


Writes TIFF for the best representation to stream 
Writes TIFF for all the representations to stream 


Registers a new class for managing image data 
Unregisters a class for managing image data 

Returns image rep that handles data of type 


Inverts the polarity of the y-axis for drawing the image 
Returns whether the polarity of the y-axis is inverted 
Determines whether representations are scaled to fit 
Returns whether representations are scaled to fit 
Sets the background color of the image 
Returns the background color of the image 
*)imageRep 

Has imageRep draw the representation 
Invalidates caches of all representations, so they will be 
redrawn 
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+ (Class)imageRepForPasteboardType:(NXAtom)fy/?e 

Returns image rep that handles data of type 

+ (Class)imageRepForStream:(NXStream *)stream 

Returns image rep that handles data on stream 


Testing Image Data Sources 

+ (BOOL)canInitFromPasteboard:(Pasteboard *) pasteboard 

YES if NXImage can create a representation from 
pasteboard 

Returns an array of supported image data file types 
Returns an array of supported pasteboard types 


+ (const char *const *)imageFiIeTypes 
+ (const NXAtom *)imagePasteboardTypes 


Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 

- finishUnarchiving 


Reads the NXImage and its representations from stream 
Writes the NXImage and its representations to stream 
Replaces the NXImage with one having the same name 


Methods Implemented by the Delegate 

- (NXImage *)imageDidNotDraw:se«£/er Responds to message that image couldn’t be composited 

inRect:(NXRect *)aRect 


NXImageRep 


Inherits From: Object 

Initializing 

- initFromPasteboard: (Pasteboard *) pasteboard Initializes the receiver from pasteboard 

Checking data types 

+ (BOOL)canInitFromPasteboard:(Pasteboard *)pasteboard 

YES if NXImageRep can initialize itself from pasteboard 

+ (BOOL)canLoadFromStream:(NXStream *)stream 

YES if NXImageRep can initialize itself from stream 
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+ (const char *const *)imageFileTypes Returns an array of strings representing all file types 

+ (const NXAtom *)imagePasteboardTypes Returns an array representing all pasteboard types 

+ (const char *const *)imageUnfilteredFileTypes Returns an array representing directly supported file types 

+ (const NXAtom *)imageUnfilteredPasteboardTypes 

Returns an array representing directly supported 
pasteboards 


Setting the Size of the Image 

- setSize:(const NXSize *)aSize Sets the size of the image 

- getSize:(NXSize *)theSize Copies the size of the image into the tlieSize structure 

Specifying Information about the Representation 


- setNumColors:(int)an/nt 

- (int)numColors 

- setAlpha:(BOOL)/fag 

- (BOOL)hasAlpha 

- setBitsPerSample:(int )anlnt 

- (int)bitsPerSample 

- setPixelsHigh:(int)an/nt 

- (int)pixelsHigh 

- setPixelsWide:(int)an//jt 

- (int)pixelsWide 

Drawing the Image 

- (BOOL)draw 

- (BOOL)drawAt:(const NXPoint *)point 

- (BOOL)drawIn:(const NXRect *)rect 

Archiving 

- read:(NXTypedStream *)stream 

- write: (NXTypedStream *)stream 


Informs the object that there are anlnt color components 
Returns the number of color components 
Informs object whether there is a coverage component 
Returns whether there is a coverage component 
Informs object there are anlnt bits/pixel in a component 
Returns the number of bits per pixel in each component 
Informs object that data is for an image anlnt pixels high 
Returns the height specified in the image data 
Informs object that data is for an image anlnt pixels wide 
Returns the width specified in the image data 


Implemented by subclasses to draw the image 
Modifies current coordinates so image is drawn at point 
Modifies current coordinates so image is drawn in rect 


Reads the NXImageRep from stream 
Writes the NXImageRep to stream 
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NXJournaler 


Inherits From: Object 


Initializing and Freeing a Journaler 

-Init 

-free 

Controlling Journaling 

- setE ventS tatus: (int )eventStatus 

soundStatus:(int)5wmdS'tata.s' 
eventStream:(NXStream *)stream 
soundfiIe:(const char *)soundfile 

- getEventStatus:(int *)eventStatusPtr 

soundStatus: (int *)soundStatusPtr 
eventStream:(NXStream **)streamPtr 
soundfile:(char **)soundfilePtr 

- setRecordDevice:(int)devi'ce 

- (int)recordDevice 

Identifying Associated Objects 

- speaker 

- listener 

- seiDe\egate:anObject 
_delegate 

Implemented by the delegate 

- journalerDidEnd:yoMrnfl/er 
-journalerDidUser Abort 


Initializes a new NXJournaler 
Deallocates the NXJournaler 


Controls recording and playback 


Provides status information about the NXJournaler 


Sets whether CODEC or DSP is used for sound input 
Returns NX_CODEC or NX_DSP 


Returns the NXJoumaler’s Speaker object 
Returns the NXJoumaler’s Listener object 
Sets the NXJoumaler’s delegate 
Returns the NXJournaler’s delegate 


Informs the delegate that the session terminated 
Informs the delegate that the user aborted the session 
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NXPrinter 


Inherits From: Object 

Finding an NXPrinter 

+ (NXPrinter *)nevvForName:(const char *)name 

Returns the NXPrinter with the given name 

+ (NXPrinter *)newForName:(const char *)name Returns the NXPrinter with the given name and host 
host:(const char *)hostName 

+ (NXPrinter *)newForName:(const char *)name Returns the NXPrinter with the given name, host, and 
host:(const char *)hostName domain 

domain:(const char *)domain 
includeUnavailable:(BOOL)mc/Mt/eF/ag 

+ (NXPrinter *)newForType:(const char *)type Returns an NXPrinter object for a given printer type 

+ (char **)printerTypes:(BOOL)norma/F/ag Returns the names of the recognized printer types 

custom: (B O OL )customFlag 

Printer Attributes 

- (const char *)domain 

- (const char *)host 

- (const char *)name 

- (const char *)note 

- (const char *)type 

- (BOOL)isReallyAPrinter 

Retrieving Specific Information 

- (BOOL)acceptsBinary Returns YES if the printer accepts binary PostScript 

- (NXRect)imageRectForPaper: (const char *)paperType 

Returns the printing rectangle for the named paper type 

- (NXSize)pageSizeForPaper:(const char *)paperType 

Returns the size of the page for the named paper type 

- (BOOL)isColor Returns whether the printer can print color 

- (BOOL)isFontAvaiIable:(const char *)name Returns whether the named font is available to the printer 

- (BOOL)isValid Returns whether the NXPrinter is valid 


Returns the name of the printer’s domain 

Returns the name of the printer’s host computer 

Returns the printer’s name 

Returns the note associated with the printer 

Returns the name of the printer’s type 

Returns whether the object corresponds to an actual printer 
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- (int)languageLevel Returns the PostScript Language Level recognized by the 

printer 

- (BOOL)isOutputStacklnReverseOrder Returns whether the printer outputs pages in reverse page 

order 


Querying the NXPrinter Tables 

- (BOOL)booleanForKey:(const char *)key 

inTable: (const char *)table 

- (void *)dataForKey:(const char *)key 

inTable: (const char *)table 
length:(int *)bytes 

- (float)floatForKey:(const char *)key 

inTable:(const char *)table 

- (int)intForKey:(const char *)key 

inTable:(const char *)table 

- (NXRect)rectForKeyi(const char *)key 

inTable: (const char *)table 

- (NXSize)sizeForKey:(const char *)key 

inTable:(const char *)table 

- (const char *)stringForKey: (const char *)key 

inTable:(const char *)table 

- (const char **)stringListForKey:(const char *)key 

inTable:(const char *)table 

- (int)statusForTable:(const char *)table 

- (BOOL)isKey: (const char *)key 

inTable:(const char *)tableg 


Returns a boolean value for the given key in the given table 
Returns untyped data for the key in the table 

Returns a float value for the key in the table 
Returns an integer value for the key in the table 
Returns an NXRect for the key in the table 
Returns an NXSize for the key in the table 
Returns a string for the key in the table 

Returns an array of strings for the key in the table 
Returns the status of the given table 
Returns whether key is a key to table 


NXSpellChecker 

Inherits From: Object 

Making A Checker Available 

+ sharedlnstance Returns the NXSpellChecker to use 

+ sharedlnstance: (BOOL )flag Returns the NXSpellChecker to use but creates a new one 

only when flag is YES 
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Managing The Spelling Panel 


- spellingPanel 

- accessory View 

- setAccessoryView:aVzew 

Checking Spelling 

- (BOOL) checkSpelling:(NXSpellCheckMode)/imv 

of:(id <NXReadOnlyTextStream, 
NXSelectRange>)anO£y'ecr 

- (BOOL) checkSpelling:(NXSpellCheckMode)/zmv 

of:(id <NXReadOnlyTextStream, 

NXS electRange>)an Object 
wordCount:(int *)theCount 

Managing the Language Being Checked 

- (const char*) language 

- setLanguage: (const char *)aLanguage 

Managing Ignored Words 

- closeSpellClient:aC7zent 

- (char **)ignoredWordsForSpellClient:aC7zent 

- setlgnoredWords: (const char *const *)someWords 

forSpellClient: (int)tag 


Returns the NXSpellChecker’s panel 
Returns the spell panel’s accessory view 
Makes a view an accessory of the spell panel 


Starts the search for a misspelled word 

Starts the search for a misspelled word and the count of 
words 


Returns the current spelling language 
Sets the current spelling language 


Notifies the NXSpellChecker that a document has closed 
Returns the list of ignored words for a document 

Initializes the list of ignored words for a document 


NXSpellServer 

Inherits From: Object 

Checking in Your Service 

- (BOOL)registerLanguage:(const char *)language 
byVendor:(const char *)vendor 


Classes: NXSpellServer 2-69 




Assigning a Delegate 

- delegate Returns the NXSpellServer’s delegate 

- seiDelegateianObject Makes the spelling service program the delegate of the 

NXSpellServer object 


Running the Service 
-run 


Starts the event loop in the NXSpellServer’s delegate 


Checking User Dictionaries 

- (BOOL)isInUserDictionary:(const char *)word Returns YES if the word is in any open user dictionary 

caseSensitive:(BOOL]/7ag 


Seeking alternative spellings 

- addGuess: (const char *)guess 


Called by the delegate to append the guesses it has found 


Methods Implemented by the Delegate 

- (BOOL)spellServer:(NXSpellServer *)sender Searches for a misspelled word; return YES if one is found 

findMisspelledWord:(int *)start 

length :(int *)length 

inLanguage:(const char *) language 

inTextStream: (id <NXReadOnlyTextStream>)fejcr5'rre«m 

startingAt: (int )startPosition 

wordCount:(int *)number 

countOnly:(BOOL )flag 

- (void)spellServer: (NXSpellServer *)sender Searches for alternatives to the misspelled word; returns 

suggestGuessesForWord: (const char *)word guesses as a side effect, using addGuess: 
inLanguage:(const char *) language 

- (void)spellServer:(NXSpellServer *) sender 

didLearnWord:(const char *)word 
inLanguage:(const char *) language 

- (void)spellServer:(NXSpellServer *)sender 

didForgetWord:(const char *)word 
inLanguage: (const char *) language ; 


Notifies the delagte of a word added to the user’s hidden 
wordlist 

Notifies the delagte of a word removed from the user’s 
hidden wordlist 
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NXSplitView 


Inherits From: View : Responder : Object 

Initializing an NXSplitView 

- initFrame:(const NXRect *)frameRect 

Handling Events 

- mouseDown:(NXEvent *)theEvent 

- acceptsFirstMouse 

Managing Component Views 

- adjustSubviews 

- resizeSubviews: 

- (NXCoord)dividerHeight 

- drawSelf:(const NXRect *) rects :(int )rectCount 

- drawDivider: (const NXRect *)aRect 

- setAutoresizeSubviews:(BOOL )flag 

Assigning a Delegate 

- seiDelegateianObject 

- delegate 

Implemented by the Delegate 

- split Vie wDidResizeSubviews ’.sender 

- split View '.sender 

getMinY:(NXCoord *)minY 
maxY:(NXCoord *)maxY 
ofSubviewAt: (int)offset 

- split Wiewisender 

resizeSubviews:(const NXSize *)oldSize 


Initializes a new NXSplitView 


Handles mouse-down events 

Allows the NXSplitView to respond to the mouse event that 
makes its Window the key window 


Adjusts the heights of the subviews 
Forces adjustment of the subviews 
Returns the height of the divider 
Draws the NXSplitView 
Draws the divider 

Ensures that the subviews are automatically resized 


Sets the NXSplitView’s delegate 
Returns the NXSplitView’s delegate 


Informs the delegate that subviews were resized 
Limits divider travel 


Allows custom resizing behavior 
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Object Additions 

This method is declared in the Application Kit as an addition to the root Object class. 


Sending Messages Determined at Run Time 

- perform: (SEL)aSelector Sends an aSelector message to the receiver after ms delay 

with :anObject 
afterDelay:(int)m.s' 
cancelPrevious:(BOOL)//ag 


OpenPanel 


Inherits From: SavePanel: Panel: Window : Responder : Object 


Creating and Freeing an OpenPanel 

+ new Returns the shared OpenPanel object 

+ newContent:(const NXRect *)contentRect Returns the shared OpenPanel object 

style: (int )aStyle 
backing: (mt)bufferingType 
buttonMask: (int)mask 
defer:(BOOL)/7 ag 

- free Deallocates the OpenPanel object 


Setting the OpenPanel Class 

+ setOpenPanelFactoryrcfrm 


Sets class for initializing an OpenPanel 


Filtering Files 

- al!owMultipleFiIes:(BOOL)/?ag Sets whether the user can open multiple files 


Querying the Chosen Files 

- (const char *const *)filenames 


Gets the names of the selected files 


2-72 Chapter 2: Application Kit 




Running the OpenPanel 


- (int)runModalForDirectory:(const char *)path Displays the panel and begins its event loop 

file:(const char *)name 

- (int)runModalForDirectory:(const char *)path Displays the panel and begins its event loop 

file:(const char *)name 
types:(const char *const *)fileTypes 

- (int)runModalForTypes:(const char *const *)fileTypes 

Displays the panel and begins its event loop 


PageLayout 


Panel: Window : Responder : Object 


Inherits From: 

Creating and Freeing a PAgeLayout Instance 

+ new 

+ newContent: (const NXRect *)contentRect 
style :(int )aStyle 
backing:(int )bufferingType 
buttonMask:(int )mask 
defer:(BOOL )flag 

-free 

Running the PageLayout Panel 

- (int)runModal 

Customizing the PageLayout Panel 

- setAccessoryView:aVh?w 

- accessory View 

Updating the Panel's Display 

- pickedLayoutrsencfer 

- pickedOrientation:sender 

- pickedPaperSize:sen<ier 


Returns a default PageLayout object 
Used in PageLayout instantiation 


Deallocates the PageLayout panel 


Displays the panel and begins its event loop 


Adds a View to the panel 

Returns the PageLayout’s accessory View 


Updates the panel when a new layout is selected 
Updates the panel with the selected orientation 
Updates the panel when a paper size is selected 
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- pickedUnits render 

- textDidEnd itextObject 

endChar: (unsigned short )theChar 

- (BOOL)textWillChange:tejtf(96/ecr 

- convertOIdFactor:(float *)old 

newFactor: (float *)new 

- pickedButtomsender 

Communicating with the Printlnfo Object 

- readPrintlnfo 

- writePrintlnfo 


Updates the panel when a new unit is selected 
Updates the panel when the user finishes typing a page size 

Updates the panel when a page size is typed 
Converts units for pickedUnits: method 

Stops the event loop 


Reads the PageLayout’s values from the Printlnfo object 
Writes the PageLayout’s values to the Printlnfo object 


Panel 


Inherits From: Window : Responder : Object 


Initializing a New Panel 
-init 

- initContent:(const NXRect *)contentRect 

style :(int)aStyle 
backing: (mi)bujfering Type 
buttonMask:(int)m<zs , & 
defer: (BOOL)flag 

Handling Events 

- (BOOL)commandKey:(NXEvent *)theEvent 

- keyDown:(NXEvent *)theEvent 

Determining the Panel Interface 

- setBecomeKeyOnlyIfNeeded:(BOOL)/fag 

- (BOOL)doesBecomeKeyOnlylfNeeded 

- setFloatingPanel:(BOOL)/fag 


Initializes the new Panel with default values 
Initializes the new Panel as specified 


Initiates performKeyEquivalent: messages 
Convert key-down event to a commandKey: message 


Sets whether Panel waits to become key window 
Returns whether Panel waits to become key window 
Sets whether the Panel floats above other windows 
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- (BOOL)isFloatingPanel 

- setWorksWhenModal:(BOOL)/fag 

- (BOOL)worksWhenModal 


Returns whether the Panel floats above other windows 
Sets whether the Panel can operate on an attention panel 
Returns whether Panel can operate on an attention panel 


Pasteboard 


Inherits From: Object 

Creating and Freeing a Pasteboard 

+ new 

+ newName:(const char *)name 

+ newUnique 
-free 

- freeGlobally 

Getting Data in Different Formats 

+ newByFilteringFile:(const char *)filename 

+ newByFilteringData:(NXData *)data 
ofType:(const char *)type 

+ newByFilteringTypesInPasteboard: 

(Pasteboard *)pboard 

+ (NXAtom *)typesFilterableTo: 

(const char *)type 

Referring to a Pasteboard by Name 

+ newName: (const char *)n ame 

- (const char *)name 

Writing Data 

- declareTypes:(const char *const *)newTypes 

num:(mt)numTypes 
owner inewOwner 


Returns the selection Pasteboard object 
Returns the Pasteboard object named name 
Creates a uniquely named Pasteboard 
Releases the Pasteboard object’s storage 
Frees the object and the domain for its name 


Creates a pasteboard with all types for filename 
Creates a pasteboard with all types for data 

Creates a pasteboard with all types filterable 
from pboard 

Returns all types type can be filtered to 


Returns the Pasteboard object named name 
Returns the Pasteboard object’s name 


Sets data types and owner of the Pasteboard 
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(int)addTypes:(const char *const *)newTypes 
num:(int)numTypes 
owner:newOwner 

writeType:(const char *)dataType 
data:(const char *)theData 
length: (int )numBytes 

writeType:(const char *)dataType 

fromStream:(NXStream *)stream 

(BOOL)writeFileContents: 

(const char *) filename 


Addsdata types to the pasteboard 

Writes theData to the pasteboard server 

Writes stream data to the pasteboard server 
Writesdata from filename to the pasteboard server 


Discerning Types 

- (const NXAtom *)types 

- (const char *)findAvailableTypeFrom: 

(const char *const *)types 

Reading Data 

- (int)changeCount 

- readiype: (const char *)dataType 

data: (char **)theData 
length:(int *)numBytes 

- (NXStream *)readTypeToStream: 

(const char *)dataType 

- (char *)readFiIeContentsType: 

(const char *)type 
toFile: (const char *)filename 

- deallocatePasteboardData:(char *)data 

length:(int)nwmfivte.s 

Methods Implemented by the Owner 

- pasteboard^cnJer 

provideData: (NX Atom)type 

- pasteboardChangedOwner:sen<i<?r 


Returns an array of the Pasteboard’s data types 

Returns first type in types that matches a pasteboard 
type 

Returns the Pasteboard’s change count 
Reads data from the pasteboard server 

Returns a stream to pasteboard data 
Writes pasteboard data to a file 

Deallocates data received from the pasteboard 

Implemented to write promised data to sender as type 
Notifies prior owner that ownership changed 
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PopUpList 


Inherits From: Menu : Panel: Window : Responder : Object 

Initializing a PopUpList 

- init Initializes a new PopUpList 


Setting Up the Items 

- addltem: (const char *)title 

- insertltem: (const char *)title 

at: (unsigned mt)index 

- removeltem: (const char *)title 

- removeltemAt: (unsigned int)index 

- (int)indexOHtem: (const char *)title 

- (unsigned int)count 


Adds an item with title as its title to the end of the list 
Inserts an item with title as its title at position index 

Removes the item matching title 
Removes the item at the specified index 
Returns the index of the item matching title 
Returns the number of items in the list 


Interacting with the Trigger Button 

- changeButtonTitle:(BOOL)/?tfg 

- getButtonFrame:(NXRect *)bFrame 


Sets whether the PopUpList is a pop-up or a pull-down list 
Gets the size needed for the Button that pops up the list 


Activating the PopUpList 

- popUp '.trigger 

Returning the User's Selection 

- (const char *)selectedltem 

Modifying the Items 

- setFonUfontObject 

-font 


Pops the list up over trigger 


Returns the title of selected item 


Sets the Font used to draw the items 
Returns the Font used to draw the items 
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Target and Action 


- setAction:(SEL)aSe/ector Sets the PopUpList’s action method to aSelector 

- (SEL)action Returns the PopUpList’s action method 

- setTarget :anObject Sets the PopUpList’s target object to anObject 

- target Returns the PopUpList’s target object 

Resizing the PopUpList 

- sizeWindow:(NXCoord)vW<M : (NXCoord)height Resizes the PopUpList to width, height 


Printlnfo 


Inherits From: Object 

Initializing and Freeing a Printlnfo Instance 

- init 

- free 

Defining the Printing Rectangle 

- setMarginLeft:(NXCoord)/e/rMargni 

right:(NXCoord)ng/nMargm 
top:(NXCoord )topMargin 
bottom:(NXCoord )bottomMargin 

- getMarginLeft:(NXCoord *)leftMargin 

right:(NXCoord *)rightMcirgin 
top:(NXCoord *)topMargin 
bottom:(NXCoord *)bottomMargin 

- setOrientation:(char)/raode 

and Adjust: (BOOL )flag 

- (char)orientation 

- setPaperRect:(const NXRect *)aRect 

and Adjust: (B OOL)flag 

- (const NXRect *)paperRect 

- setPaperType:(const char *)type 

andAdjust:(BOOL)//ag 

- (const char *)paperType 


Initializes the Printlnfo instance after it’s allocated 
Deallocates the Printlnfo object 

Sets the margins 

Returns the margins by reference 

Sets the orientation as portrait or landscape 

Returns the orientation is portrait or landscape 
Sets the width and height of the paper 

Returns the rectangle for the paper size 
Sets the paper type 

Returns the paper type 
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Page Range 


- setFirstPage:(int)tf/z//if 

- (int)firstPage 

- setLastPage:(int)zw/m 

- (int)lastPage 

- setAllPages:(BOOL)//ag 

- (BOOL)isAllPages 

- (int)currentPage 


Sets the page number of first page to be printed 
Returns the page number of the first page to be printed 
Sets the page number of last page to be printed 
Returns the page number of the last page to be printed 
Sets whether all the pages are to be printed 
Returns whether all the pages are to be printed 
Returns the page number of the page being printed 


Pagination and Scaling 

- setHorizPagination:(int)m 0 z/<? 

- (int)horizPagination 

- setVertPagination:(int)mo(7e 

- (int)vertPagination 

- setScalingFactor:(float)flF/oar 

- (float)scalingFactor 


Sets the horizontal pagination mode 
Returns the horizontal pagination mode 
Sets the vertical pagination mode 
Returns the vertical pagination mode 
Sets the scaling factor 
Returns the scaling factor 


Positioning the Image on the Page 

- setHorizCentered:(BOOL)/?ag 

- (BOOL)isHorizCentered 

- setVertCentered:(BOOL)/?ag 

- (BOOL)isVertCentered 

- setPagesPerSheet:(short)tfS7z0/t 

- (short)pagesPerSheet 


Sets whether the image is centered horizontally 
Returns whether the image is centered horizontally 
Sets whether the image is centered vertically 
Returns whether the image is centered vertically 
Sets the number of pages printed per sheet of paper 
Returns the number of pages printed per sheet of paper 


Print Job Attributes 

- initializeJobDefaults 

- setJobFeature:(const char *)feature 

to Value: (const char *)value 

- (const char *)valueForJobFeature:(const char * 

- removeJobFeature:(const char *)key 

- (const char **)jobFeatures 

- setPageOrder:(char)moz7e 

- (char)pageOrder 

- setReversePageOrder:(BOOL)/7ag 

- (BOOL)reversePageOrder 


Invoked automatically to initialize printing defaults 
Sets the value of the given printing job feature 

ture 

Returns the value for the given .printing job feature 
Removes the given printing job feature 
Returns the keys to the job features table 
Sets the order in which pages will be printed 
Returns the order in which pages will be printed 
Sets whether the page order is reversed 
Returns whether the page order is reversed 
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- setCopies:(int)an/nr 

- (int)copies 

- setPaperFeed:(const char *)paperFeedSlot 

- (const char *)paperFeed 

Specifying the Printer 

+ setDefaultPrinter:(NXPrinter *)printer 
+ (NXPrinter *)getDefau!tPrinter 

- setPrinter:(NXPrinter *)aPrinter 

- (NXPrinter *)printer 

Spooling 

- setOutputFile:(const char *)aString 

- (const char *)outputFile 

- setContext:(DPSContext)aContexf 

- (DPSContext)context 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Sets the number of copies to be printed 
Returns the number of copies to be printed 
Sets the paper feed slot used during printing 
Returns the paper feed slot used during printing 


Sets the user’s default printer 

Returns the user’s default printer 

Sets the printer that’s used in subsequent printing jobs 

Returns the NXPrinter that’s used for printing 


Sets the output file for printing 
Returns the output file for printing 
Sets the DPS context used for printing 
Returns the DPS context used for printing 


Reads the Printlnfo from the typed stream 
Writes the Printlnfo to the typed stream 


PrintPanel 


Inherits From: Panel: Window : Responder: Object 


Creating and Freeing a PrintPanel 

+ new Returns a default PrintPanel object 

+ newContent:(const NXRect *)contentRect Returns a PrintPanel object 

style: (int )aStyle 
backing:(int )bufferingType 
buttonMask:(int )mask 
defer: (BOOL )flag 

- free Deallocates the PrintPanel 
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Customizing the PrintPanel 

- setAccessoryVie\v:«Vfew Adds a View to the panel 

- accessoryView Returns the accessory View 


Running the Panel 

- (int)runModal 

- pickedButton:sc/z<ier 

Updating the Panel's Display 

- pickedAllPages:s<?/ 2 £fer 

- (BOOL)textWillChang e:textObject 

Communicating with the Printlnfo Object 

- updateFromPrintlnfo 

- finalWritePrintlnfo 


Displays the Print panel and begins its event loop 
Stops the event loop 


Updates the panel when the user chooses all pages 
Updates the panel when user types pages to print 


Reads PrintPanel’s values from the Printlnfo object 
Writes PrintPanel’s values to the Printlnfo object 


Responder 


Inherits From: Object 

Managing the NeXT Responder 

- setNextResponder:aResponder 

- nextResponder 

Determining the First Responder 

- (BOOL)acceptsFirstResponder 

- becomeFirstResponder 

- resignFirstResponder 


Makes aResponder the receiver’s next responder 
Returns the receiver’s next responder 


Returns NO to refuse first responder status 
Notifies the receiver it’s the first responder 
Notifies the receiver it’s not the first responder 
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*)theEvent 

Returns NO to indicate theEvent isn’t handled 
Aids in dispatching action messages 


Aiding Event Processing 

- (BOOL)performKeyEquivalent:(NXEvent 

- (BOOL)tryToPerform:(SEL)a/iAcdon 

with :anObject 

Forwarding Event Messages 

- mouseDown:(NXEvent *)theEvent 

- rightMouseDown:(NXEvent *)theEvent 

- mouseDragged:(NXEvent *)theEvent 

- rightMouseDragged:(NXEvent *)theEvent 

- mouseUp:(NXEvent *)theEvent 

- rightMouseUp:(NXEvent *)theEvent 

- mouseMoved:(NXEvent *)theEvent 

- mouseEntered:(NXEvent *)theEvent 

- mouseExited:(NXEvent *)theEvent 

- keyDown:(NXEvent *) theEvent 

- keyUp:(NXEvent *)theEvent 

- flagsChanged:(NXEvent *)theEvent 

- noResponderFor:(const char *)eventType 

Services Menu Support 

- validRequestorForSendiype: (NXAtom)typeSen/ 

andReturnType:(NXAtom)/ype/tetarae<i 

A "« w* 
i-11 uni vii iy 

- read:(NXTypedStream *) stream 

- write:(NXTypedStream *)stream 


Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Passes the message to the receiver’s next responder 
Prints warning message to syslog if debugging 


Implemented by subclasses to determine available services 


Reads the Responder from the typed stream stream 
Writes the Responder to the typed stream stream 
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SavePanel 


Inherits From: Panel: Window : Responder : Object 


Creating and Freeing a SavePanel 

+ newContent:(const NXRect *)contentRect 
style: (int )aStyle 
backing: ( \n\)bufferingType 
buttonMask:(int)mav/: 
defer:(BOOL)//ag 

-free 

Setting the SavePanel Class 

+ setSavePanelFactory:c/<m 

Customizing the SavePanel 

- setAccessoryView:a View 

- accessoryView 

- setTitle: (const char *)title 

- setPrompt: (const char *)prompt 

Setting Directory and File Type 

- setDirectory: (const char *)path 

- setRequiredFileType: (const char *)type 

- (const char *)requiredFileType 

Running the SavePanel 

- (int)runModalForDirectory:(const char *)path 

file:(const char *)name 

- (int)runModal 

Reading Save Information 

- (const char *)directory 

- (const char *)filename 


Creates and returns a SavePanel object 


Deallocates the SavePanel 


Sets class for initializing an SavePanel 


Adds application-customized view to the panel 
Returns the application-customized view 
Sets the title of the SavePanel to title 
Sets the title of the file name form field 


Sets the current directory of the SavePanel 
Sets the required file type (if any) 

Gets the required file type (if any) 


Displays the SavePanel and begins its event loop 
Displays the SavePanel and begins its event loop 


Returns directory chosen file resides in 
Returns full name of file to be saved 
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Completing a Partial Filename 

- (BOOL)commandKey:(NXEvent *)theEvent Enables command-space to do filename completion 

Target and Action Methods 

- ok: sender Method invoked by the OK button 

- canc ehsender Method invoked by the Cancel button 


Responding to User Input 

- selectText: sender Called when TAB is pressed in the form 

- tex(DidEnd:textObject Determines whether TAB or BACKTAB was pressed 

endChar: (unsigned short )endChar 

- textDidGetKeys:te;tfC%' isEmpty:(BOOL)/?ag Determines whether there’s any text in the form 


Setting the Delegate 

- setDelega te:anObject 


Makes anObject the SavePanel’s delegate 


Methods implemented by the Delegate 

- (int)panel '.sender Returns 1 if filenamel precedes filename2, -1 in the 

compareFilenames: (const char *)fileNamel opposite case, 0 if the two are equivalent 

:(const char *)fileName2 
checkCase: (BOOL)flag 

- (BOOL)panel:.yen<ier YES if filename can be saved in directory 

filterFile: (const char *) filename 
inDirectory: (const char *) directory 

- (BOOLOpanelValidateFilenamesuerccfer YES if the filename is acceptable to the delegate 


ScroEBer 


Inherits From: Control: View : Responder : Object 

Initializing a Scroller 

- initFrame:(const NXRect *)frameRect Initializes a new Scroller 
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Laying out the Scroller 

- (NXRect *)calcRect: (NXRect *)aRect 

forPart:(int)par/C0zte 

- checkSpaceForParts 

- setArrowsPosition:(int)\v/jere 

Setting Scroller values 

- (float)float Value 

- setFloatValue:(float)aF/oaf 

- setFloat Value: (float)aFZoar :(f\oai)percent 

Resizing the Scroller 

- sizeTo:(NXCoord)vv/fifr/i :(NXCoord )height 

Displaying 

- drawArrow:(BOOL )whichButton :(BOOL )flag 

- drawKnob 

- drawParts 

- drawSelf:(const NXRect *)rects :(int )rectCount 

- highlight:(BOOL)/fag 

Target and Action 

- setAction:(SEL)flSWecfor 

- (SEL)action 

- setTarget :anObject 

- target 

Handling Events 

- (BOOL)acceptsFirstMouse 

- (int)hitPart 

- mouseDown:(NXEvent *)theEvent 

- (int)testPart:(const NXPoint *)thePoint 

- trackKnob:(NXEvent *)theEvent 

- trackScrollButtons:(NXEvent *)theEvent 


Gets the rectangle that encloses partCode 

Checks for room for knob and scroll buttons 
Sets position of scroll buttons in Scroller 


Returns Scroller’s float value 

Sets value; positions knob 

Sets value; positions and sizes knob 


Sizes the Scroller 


Draws highlighted and unhighlighted arrows 
Draws the knob 

Caches Bitmaps for knob and scroll arrows 
Draws the Scroller 

Highlights scroll button that’s under mouse 


Sets the Scroller’s action to aSelector 
Returns the Scroller’s action 
Sets the Scroller’s target to anObject 
Returns the Scroller’s target 


Makes the Scroller respond to the first mouse event 
Returns Scroller part that received mouse-down 
Responds to mouse-down events 
Returns Scroller part that’s under thePoint 
Responds to mouse-down events on the knob 
Responds to mouse-down events on buttons 
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Archiving 

- awake 

- read:(NXTypedStream *) stream 

- write:(NXTypedStream *) stream 


Ensures that Scroller’s Bitmaps are created 
Reads the Scroller from the typed stream 
Writes the Scroller to the typed stream 


ScrollView 


Inherits From: View : Responder : Object 


Initializing a ScrollView 

- initFrame:(const NXRect *)frameRect 

Determining Component Sizes 

- getContentSize:(NXSize *)contentViexvSize 

- getDocVisibleRect:(NXRect *)aRect 

Laying Out the ScrollView 

+ getContentSize:(NXSize *)cSize 

forFrameSize: (const NXSize *)j$ize 
horizScroller:(BOOL )hFlag 
vertScroller:(BOOL)vF7tfg 
borderType:(int)a7yp£> 

+ getFrameSize:(NXSize *)fSize 

forContentSize:(const NXSize *)cSize 
horizScroller:(BOOL)/jF/< 2 g 
vertScroller:(BOOL)vF/ag 
borderType:(int)a7y/?e 

- resizeSubviews:(const NXSize *)oldSize 

- setHorizScrollerRequired: (BOOL )flag 

- setVertScrollerRequired:(BOOL)//ag 

- tile 


Initializes a new ScrollView 


Gets the content view’s size 

Gets the visible portion of the document view 


Gets the content view size for the given ScrollView size 


Gets the ScrollView size for the given content view size 


Retiles the ScrollView after a sizeTo:: 
Makes space for a horizontal scroller 
Makes space for a vertical scroller 
Retiles the scrollers and content view 


2-86 Chapter 2: Application Kit 




Managing Component Views 

- setDocView:aV7cw 

- docView 

- setHorizScro\ler:anObject 

- horizScrolIer 

- setVertScroller :anObject 

- vertScroller 

- reflectScroll:cV/ew 

Modifying Graphic Attributes 

- setBorderType:(int)a7y/?e 

- (int)borderType 

- setBackgroundColor:(NXColor)co/or 

- (NXColor) backgroundColor 

- setBackgroundGray:(float)va/we 

- (float)backgroundGray 

Setting Scrolling Behavior 

- setCopyOnScroll:(BOOL)/7ag 

- setDisplayOnScroll:(BOOL)/7ag 

- setDynamicScrolling:(BOOL)/fag 

- setLineScroll:(float)va/we 

- setPageScroll:(float)vfl/He 

Displaying 

- drawSelf: (const NXRect *)rects :(int)rectCount 

Managing the Cursor 

- setDocCursor:an06/ 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Makes aView the ScrollView’s document view 

Returns the current document view 

Sets the horizontal Scroller object 

Returns the horizontal Scroller 

Sets the vertical Scroller object 

Returns the vertical Scroller 

Updates the Scrollers 


Determines the border type of the ScrollView 
Returns the border type 
Sets the ScrollView’s background color 
Returns the ScrollView’s background color 
Sets the ScrollView’s background gray 
Returns the ScrollView’s background gray 


Sets how newly exposed areas are redrawn 
Sets how the doc view is displayed during scrolling 
Sets how the doc view is displayed during scrolling 
Sets the amount to scroll when scrolling a line 
Sets the amount of overlap for a page scroll 


Draws the ScrollView 


Sets the cursor for the document view 


Reads the ScrollView from the typed stream 
Writes the ScrollView to the typed stream 
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SelectionCell 


Inherits From: Cell: Object 

Creating a SelectionCell 

- init 

- initTextCell:(const char *)aString 

Determining Component Sizes 

- calcCellSize:(NXSize *)theSize 

inRect:(const NXRect *)ciRect 

Accessing Graphic Attributes 

- setLeaf:(BOOL)/7ag 

- (BOOL)isLeaf 

- (BOOL)isOpaque 

Displaying 

- drawSelf:(const NXRect *)cellFrcime 

in Vi evr.aView 

- drawInside:(const NXRect *)cellFrame 

in View :aView 

- highlight:(const NXRect *)cellFrame 

inVievr.aView 
lit:(BOOL )flag 

Archiving 

- awake 


Initializes a new SelectionCell with “Listltem” as its title 
Initializes a new SelectionCell with aString as its title 


Calculates the size of the SelectionCell within aRect 


Sets whether SelectionCell is a leaf or a branch 
Returns whether the SelectionCell is a leaf or a branch 
Returns YES, since SelectionCells are opaque 


Draws the SelectionCell in cellFrame within aView 

Draws the inside of the SelectionCell in aView 

Highlights the SelectionCell within cellFrame in 
controlView 


Reinitializes the SelectionCell when it’s unarchived 
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Slider 


Inherits From: Control: View : Responder : Object 


Setting Slider's Cell Class 

+ setCellClass :classld 

Initializing a new Slider 

- initFrame:(const NXRect *)frameRect 

Modifying a Slider's appearance 

- setKnobThickness: (NXCoord )aFloat 

- (NXCoord)knobThickness 

- setlmage: image 

- image 

- setTitle: (const char *)aString 

- setTitleNoCopy: (const char *)aString 

- (const char *)title 

- setTitleCell:aCe// 

- titleCell 

- setTitleFont :fontObject 

- titleFont 

- setTitleCo!or:(NXColor)aCo/or 

- (NXColor)titleCoIor 

- setTitleGray:(float)aF/oaf 

- (float)titleGray 

- (int)isVertical 

Setting Value Limits 

- setMinValue:(doubl o)aDouble 

- (double)min Value 

- setMaxValue: (doub\e)aDouble 

- (double)maxValue 


Sets the subclass of SliderCell used by Slider 


Initializes a new Slider in frameRect 


Sets the knob’s thickness to aFloat 

Returns the knob’s thickness 

Sets the background image to image 

Returns the background image 

Sets the background title to a copy of aString 

Sets the background title to aString 

Returns the background title 

Sets the Cell used to draw the background title 

Returns the Cell used to draw the background title 

Sets the Font used to draw the background title 

Returns the Font used to draw the background title 

Sets the color of text in the background title to aColor 

Returns the color of text in the background title 

Sets the gray of text in the background title to aFloat 

Returns the gray of text in the background title 

Returns 1 if vertical, 0 if horizontal, -1 if unknown 


Sets the Slider’s minimum value to aDouble 
Returns the Slider’s minimum value 
Sets the Slider’s maximum value to aDouble 
Returns the Slider’s maximum value 
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Resizing the Slider 

- sizeToFit 


Modifies the Slider’s size to fit its Cell 


Handling Events 

- (BOOL)acceptsFirstMouse Returns YES, since Sliders always accept first mouse 

- setEnabled:(BOOL]/fag Sets whether the Slider reacts to events 

- mouseDown:(NXEvent *)theEvent Responds to mouse-down by initiating tracking 


SliderCell 


Inherits From: ActionCell: Cell: Object 

Initializing a new SliderCell 
-init 

Determining Component Sizes 

- calcCellSize:(NXSize *)theSize 

inRect: (const NXRect *)aRect 

- getKnobRect:(NXRect*)£« 0 W?ect 

flipped:(BOOL)flipped 

Setting Value Limits 

- setMin Value :(double)aDow We 

- (double)min Value 

- setMaxValue: (doub\e)aDouble 

- (double)maxValue 

Setting Values 

- setDouble Value :(double)<zD6>w We 

- (double)doubleValue 

- setFIoatValue:(float)aF/oaf 

- (float)float Value 

- setIntValue:(int)an/n? 


Initializes a new SliderCell 


Returns the size of the SliderCell 

Gets the rectangle the knob will be drawn in 


Sets the SliderCell’s minimum value to aDouble 
Returns the SliderCell’s minimum value 
Sets the maximum value of the SliderCell to aDouble 
Returns the SliderCell’s maximum value 


Sets the SliderCell’s value to aDouble 
Returns the SliderCell’s value as a double 
Sets the SliderCell’s value to aFloat 
Returns the SliderCell’s value as a float 
Sets the SliderCell’s value to anlnt 
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- (int)intValue 

- setStringValue: (const char *)aString 

- (const char *)string Value 

Modifying Graphic Attributes 

- setKnobThickness: (NXCoord )aFloat 

- (NXCoord)knobThickness 

- setlmag e: image 

- image 

- setTitle:(const char *)aString 

- setTitleNoCopy:(const char *)aString 

- (const char *)title 

- setTitleCell:aCe// 

- titleCell 

- setTitleFont:fontObject 

- titleFont 

- setTitleColor:(NXColor)aCo/or 

- (NXColor)titleColor 

- setTitleGray:(float)flF/oaf 

- (float)titleGray 

- (BOOL)isOpaque 

- (int)is Vertical 

Displaying the SliderCell 

- drawSelf:(const NXRect *)cellFrame 

inVievr.controlView 

- drawlnside:(const NXRect *)cellFrame 

in View '.controlView 

- drawBarlnside:(const NXRect *)aRect 

flipped: (B OOL)flipped 

- drawKnob 

- drawKnob:(const NXR&ct*)knobRect 

Modifying Behavior 

- setFmabled:(BOOL)//ag 

- setContinuous: (BOQL)flag 

- (BOOL)isContinuous 


Returns SliderCell’s value as an int 
Sets the SliderCell’s value to a number represented by 
aString 

Returns the the SliderCell’s value as a string 


Sets the knob’s thickness to aFloat 

Returns the knob’s thickness 

Sets the background image to image 

Returns the background image 

Sets the background title to a copy of aString 

Sets the background title to aString 

Returns the background title 

Sets the Cell used to draw the background title 

Returns the Cell used to draw the background title 

Sets the Font used to draw the background title 

Returns the Font used to draw the background title 

Sets the color of text in the background title to aColor 

Returns the color of text in the background title 

Sets the gray of text in the background title to aFloat 

Returns the gray of text in the background title 

Returns YES (SliderCells are always opaque) 

Returns 1 if vertical, 0 if horizontal, -1 if unknown 


Draws the SliderCell’s bar and knob in controlView 

Draws the inside of the SliderCell in controlView 

Draws the SliderCell’s bar 

Draws the SliderCell’s knob 

Draws the SliderCell’s knob in knobRect 


Sets whether the SliderCell reacts to events 
Sets whether the Slider is continuous 
Returns whether the Slider is continuous 
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- setAltIncrementValue:(double)/ncVfr/we 


Sets how far the SliderCell moves when the knob is 
dragged one pixel with the Alternate key held down 

- (double)altlncrementValue Returns how far the SliderCell moves when alt-dragged 

Tracking the Mouse 

+ (BOOL)prefersTrackingUntilMouseUp Returns YES, since SliderCells must track even when the 

mouse leaves their bounds 

- (BOOL)trackMouse:(NXEvent *)theEvent Tracks the mouse 

inRect: (const NXRect *)cellFrame 
oTWmvr.controlView 

- (BOOL)startTrackingAtr(const NXPoint *)startPoint 

inView:controlView Begins a tracking session 

- (BOOL)continueTracking:(const NXPoint *)lastPoint 

at: (const NXPoint *)currentPoint Continues tracking the mouse 

in View icontrolView 

- stopTracking:(const NXPoint *)lastPoint Ends the current tracking session 

at:(const NXPoint *)stopPoint 
in View icontrolView 
mouseIsUp:(BOOL)/2 ag 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 

- awake 


Speaker 

Inherits From: Object 

Initializing a New Speaker Instance 

- init Initializes the Speaker after it has been allocated 

Freeing a Speaker 

- free Deallocates the Speaker (but not its ports) 


Reads the SliderCell from stream 

Writes the SliderCell to stream 

Caches knob icons when the SliderCell is unarchived 
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Setting Up a Speaker 


- setSendTimeout:(int)ms 

- (int)sendTimeout 

- setReplyTimeout:(int)/«5 

- (int)replyTimeout 

Managing the Ports 

- setSendPort:(port_t)<3Po/T 

- (port_t)sendPort 

- setReplyPort:(port_t)aPorr 

- (port_t)replyPort 

Standard Remote Methods 

- (int)openFile:(const char *)fullPath 

ok:(int *)flag 

- (int)openTempFile:(const char *)fullPath 

ok:(int *)flag 

Providing for Program Control 

- (int)msgCaIc:(int *)flag 

- (int)msgCopyAsiype: (const char *)aType 

ok:(int *)flag 

- (int)msgCutAsType: (const char *)aType 

ok:(int *)flag 

- (int)msgDirectory:(char *const *)jullPath 

ok:(int *)flag 

- (int)msgFile:(char *const *)fullPath 

ok:(int *)flag 

- (int)msgPaste:(int *)flag 

- (int)msgPosition:(char *const *)aString 

posType:(int *)anlnt 
ok:(int *)flag 

- (int)msgPrint:(const char *)fullPath 

ok:(int *)flag 

- (int)msgQuit:(int *)flag 


Sets how long to wait for messages to be delivered 
Returns how long to wait for messages to be delivered 
Sets how long Speaker will wait for a reply 
Returns how long Speaker will wait for a reply 


Makes aPort the port messages will be sent to 
Returns the port the Speaker will send messages to 
Makes aPort the port where replies are received 
Returns the port where Speaker receives replies 


Sends a remote message to open fullPath file 
Sends a remote message to open fullPath file 


Sends message to update the current window 
Sends message to copy selection as aType data 

Sends message to cut selection as aType data 

Sends message requesting the current directory 

Sends message requesting the current document 

Sends message to paste data from pasteboard 
Sends message requesting selection information 

Sends message to print fullPath file 
Sends remote message for application to quit 
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- (int)msgSelection:(char *const *)bytes Sends message requesting the current selection 

length:(int *)numBytes 
aslope: (const char *)aType 
ok:(int *)flag 

- (int)msgSetPosition:(const char *)aString Sends message to scroll so aString is visible 

posType \(m\)anlnt 
andSelect:(int )sflag 
ok:(int *)flag 

- (int)msgVersion:(char *const *)aString Sends message requesting version information 

ok:(int *)flcig 

Sending Remote Messages 

- (int)performRemoteMethod:(const char *)methodName 

Sends remote methodName message 

- (int)performRemoteMethod:(const char *)methodName 

with:(const char *)data Sends remote message with numBytes of data 

\c.ngt\v.(\wi)numBytes 

- (int)selectorRPC:(const char *)methodName Sends remote message with variable arguments 

paramTypes:(char *)params, 

- (int)sendOpenFileMsg:(const char *)fullPath Sends an openFi!e:ok: remote message 

ok:(int *)flag 

andDeactixateSelf:(BOOL)deactivateFirst 

- (int)sendOpenTempFileMsg:(const char *)fullPath 

ok:(int *)flag Sends an openTempFilerok: remote message 

andDeactivateSelf:(BOOL)JeactivateF/r 1 s , r 

Assigning a Delegate 

- setDelegateianObject 

- delegate 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Reads the Speaker from stream 
Writes the Speaker to stream 


Makes anObject the Speaker’s delegate 
Returns the Speaker’s delegate 


2-94 Chapter 2: Application Kit 



Text 


Inherits From: View : Responder : Object 

Conforms To: NXChangeSpelling 

NXIgnoreMisspelledWords 
NXReadOnly TextS tream 
NXSelectText 

Initializing the Class Object 

+ setDefaultFont:anC%<?cr 
+ getDefaultFont 

+ excludeF romS er vicesMenu: (BOOL )flag 

+ registerDirective: (const char *) directive 
iorClassiclass 
+ initialize 

Initializing a New Text Object 

- initFrame:(const NXRect *)fra?neRect 

- initFrame:(const NXRect *)frameRect 

text: (const char *)theText 
alignment: (int )mode 

Freeing a Text Object 

- free 

Modifying the Frame Rectangle 

- setMaxSize: (const NXSize *)newMaxSize 

- getMaxSize: (NXSize *)theSize 

- setMinSize: (const NXSize *)newMinSize 

- getMinSize: (NXSize *)theSize 

- setVertResizable:(BOOL)/?flg 

- (BOOL)isVertResizable 

- setHorizResizable:(BOOL)/fag 

- (BOOL)isHorizResizable 

- sizeTo :(NXCoord) width :(NXCoord )height 


Makes anObject the default Font object for Text 
Returns the default Font object for Text 
Controls whether Text objects register for services 
Associates an RTF control word with a class object 

Performed automatically at startup 


Initialize a new Text object 
Initialize a new Text object 


Frees the Text object and its storage 


Sets maximum size of the Text object 
Gets maximum size of the Text object 
Sets minimum size of the Text object 
Gets minimum size of the Text object 
Sets whether frame height can change 
Returns whether frame height can change 
Sets whether frame width can change 
Returns whether frame width can change 
Resizes the Text object to width and height 
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- sizeToFit 

- resizeText:(const NXRect *)oldBounds 

:(const NXRect *)maxRect 

- moveTo:(NXCoord)jt :(NXCoord)y 

Laying Out the Text 

-setMarginLeft:(NXCoord)/<?/fMargm 
right: (NXCoord)rightMargin 
top: (NXCoord)topMargin 
bottom: (NXCoord)bottomMargin 

- getMarginLeft:(NXCoord *)leftMargin 

right:(NXCoord *)rightMargin 
top:(NXCoord *)topMargin 
bottom:(NXCoord *}bottomMargin 

- getMinWidth: (NXCoord *)width 

minHeight:(NXCoord *)height 

maxWidth:(NXCoord)wzWt/zMax 

maxHeight:(NXCoord)/zezg/tfMm: 

- setAIignment:(int)moz/e 

- (int)alignment 

- alignSelLeftoender 

- alignSelCentense/zder 

- aIignSeIRight:se«afer 

- setSelProp: (NXParagraphProp)/?rop 

to:(NXCoord)vrz/ 

- changeTabStopAt:(NXCoord)o/c/X 

to: (NXCoord)newX 

- (int)calcLine 

- setCharWrap:(BOOL)/7ag 

- (BOOL)charWrap 

- setNoWrap 

- setParaStyle:(void *)paraStyle 

- (void *)defau!tParaStyle 

- (void *)calcParagraphStyle:/oft?/z/ 

:(int ^alignment 

- setLineHeight:(NXCoord)va/we 

- (NXCoord)lineHeight 

- setDescentLine:(NXCoord)va/we 

- (NXCoord)descentLine 


Resizes the frame to accommodate the text 
Used by Text object to resize and redisplay itself 

Moves the Text object to (x, y) 


Adjusts margins around the text 


Gets dimensions of margins around the text 


Calculates area needed to display the text 


Sets how text is aligned at margins 

Returns how text is aligned at margins 

Aligns the text to the left margin 

Aligns the text between the margins 

Aligns the text to the right margin 

Sets the paragraph style for one or more paragraphs 

Resets the position of the specified tab stop 

Calculates line breaks 

Returns whether extra long words are wrapped 
Sets whether extra long words are wrapped 
Disables word wrap 
Sets paragraph style for the entire text 
Returns the default paragraph style 
Recalculates paragraph style 

Sets height of a line of text 

Returns height of a line of text 

Sets distance from base line to bottom of line 

Returns distance from base line to bottom of line 
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Reporting Line and Position 


- (int)lineFromPosition:(int)/?as7tz0/i 

- (int)positionFromLine:(int)/z7n? 

- (int)offsetFromPosition:(int)/;o5/7/o/7 

- (int)positionFromOffset:(int)oj^ef 


Converts character position to line number 
Converts line number to character position 
Returns the byte offset corresponding to position 
Returns the position corresponding to the byte offset 


Setting, Reading, and Writing the Text 


- setText: (const char *)aString 

- readText:(NXStream *)stream 

- startReadingRichText 

- readRichText:(NXStream *)stream 

- readRichText:(NXStream *)stream 

atPosition:(int)/?0S77/on 

- finishReadingRichText 

- (NXRTFDError)openRTFDFrom:(const char * 


Replaces current text with aString 
Replaces current text with text from stream 
Sent before Text object begins reading RTF data 
Replaces text with RTF data from stream 
Lets you add RTF data to stream 

Sent after Text object reads RTF data 

i 

Opens the RTFD file package specified by path 


- (NXRTFDError)saveRTFDTo: (const char *)path 

removeBackup:(BOOL )reinove Backup 
errorHandler lerrorHandler 

- writeText:(NXStream *)stream 

- \vriteRichText:(NXStream *)stream 

- writeRichText:(NXStream *)stream 

irom:(int)start 
to:(int )end 

- writeRTFDSelectionTo:(NXStream *)stream 

- writeRTFDTo:(NXStream *) stream 

- (NXStream *)stream 

- (NXTextBlock *)firstTextBlock 

- getParagraph:(int)prM/mZ?er 

start:(int *)startPos 
end:(int *)endPos 
rect:(NXRect *)paragraphRect 

- (int)getSubstring:(char *)buf 

start:(int )startPos 
length: (int )num Chars 

- (int)byteLength 

- (int)charLength 

- (int)textLength 


Saves the contents (text and images) of the Text object 
to the file package specified by path 

Writes all the text to stream 
Writes all the text to stream using RTF 
Writes text to stream using RTF 

Writes the selection—text and images—to stream 
Writes all the text and images to stream 
Returns stream access to Text object’s text 
Returns pointer to first text block 
Gets position, length, and size of a paragraph 


Copies numChars at startPos to buf 

Returns length of the Text object’s contents in bytes 
Returns number of characters in the text 
Returns number of characters in the text 
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Setting Editability 


- setEditable:(BOOL)/fog 

- (BOOL)isEdi table 

Allowing Multiple Fonts and Paragraph Styles 

- setMonoFont:(BOOL)yfag 

- (BOOL)isMonoFont 

Editing the Text 

- copy: sender 

- copyFon Usender 

- copyRuler ’.sender 

- paste: sender 

- pasteFont ‘.sender 

- pasteRulense/zder 

- cut: sender 

- delet eisender 

- clear '.sender 

- selectAl Usender 

- selectText: sender 

Managing the Selection 

- subscript:.semier 

- superscript:^enf/er 

- unscript^ewJer 

- underline.'sem/er 

- showCaret 

- hideCaret 

- setSelectable:(BOOL)/fag 

- (BOOL)isSelectable 

- selectError 

- selectNull 

- sctSeI:(int).starf :(int)end 

- getSel:(NXSelPt *)start :(NXSelPt *)end 

- replaceSel:(const char *)aString 


Sets whether the text can be edited 
Returns whether the text can be edited 


Controls whether multiple fonts and parastyles are OK 
Returns whether only one font and parastyle is permitted 


Copies selected text to the pasteboard 
Copies selected text’s font to the pasteboard 
Copies selected text’s style to the pasteboard 
Replaces selection with pasteboard’s contents 
Replaces selection’s font with pasteboard’s contents 
Replaces selection’s style with pasteboard’s contents 
Deletes selected text; copies it to pasteboard 
Deletes selected text 
Deletes selected text 

Makes receiver the first responder; selects all text 
Makes receiver the first responder; selects all text 


Subscripts the current selection 

Superscripts the current selection 

Removes sub/super script in the current selection 

Toggles the underline attribute of text 

Displays the previously hidden caret 

Removes the caret from the text display 

Sets whether the text can be selected 

Returns whether the text can be selected 

Selects all the text 

Deselects the current selection 

Selects text from start through end 

Gets start and end of the selection 

Replaces the selection with aString 
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- replaceSel: (const char *)aString 

length: (int )length 

- replaceSel:(const char *)aString 

length: (int)length 

runs :(NXRunArray *)insertRuns 

- replaceSelWithRichText:(NXStream *)strecim 

- replaceSelWithRTFD:(NXStream *)stream 

- scrollSelToVisible 

Setting the Font 

- setFontPanelEnabled:(BOOL)/7ag 

- (BOOL)isFontPanelEnabled 

- changeFont ‘.sender 

- setFont ifontObj 

- font 

- setFont:fontObj paraStyle:(void *)paraStyle 

- setSelFont:/onrW 

- setSelFontFamily:(const char *)fontName 

- setSelFontSize:({loat).v/z<? 

- setSelFontStyle:(NXFontTraitMask)tra;A 

- setSelFont ifontld paraStyle:(void *)paraStyle 

Checking Spelling 

- checkSpelling: sender 

- showGuessPanel:se«der 

Managing the Ruler 

- toggleRulensender 

- (NXColor)isRulerVisible 

Finding Text 

- (BOOL)findText:(const char *)string 

ignoreCase:(BOOL )ignoreCaseFlag 
backwards: (BOOL )backwardsFlag 
wrap: (B O Oh)wrapFlag 


Replaces selection with length bytes of aString 
Replaces selection with length bytes of aString 

Replaces selection with RTF from stream 
Replaces selection with RTFD data from stream 
Brings the selection within the frame rectangle 


Sets whether the Font panel can affect text 

Sets whether the Font panel can affect text 

Changes font of selection 

Sets Font object for the entire text 

Returns a monofont Text object’s font 

Sets Font and paragraph style for all text 

Sets Font object for the selection 

Sets font family for the selection 

Sets font size for the selection 

Sets font style for the selection 

Sets font and paragraph style for the selection 


Searches for a misspelled word in the text 
Displays panel suggesting spelling corrections 


Controls the display of the ruler 

Returns whether the ruler is visible in the superview 


Searches for string in the text, starting at the insertion point 


Classes: Text 2-99 



Modifying Graphic Attributes 

- setBackgroundGray: (float) value 

- (float)backgroundGray 

- setBackgroundColor:(NXColor)co/or 

- (NXColor)backgroundColor 

- setSelGray:(float)va/we 

- (float)selGray 

- (float)runGray:(NXRun *)run 

- setSelColor:(NXColor)co/or 

- (NXColor)selColor 

- (NXColor)runColor:(NXRun *)run 

- setTextGray:(float)va/we 

- (float)textGray 

- setTextColor:(NXColor)co/or 

- (NXColor)textCoIor 

Reusing a Text Object 

- renewFonUnewFontld 

text:(const char *)newText 
frame:(const NXRect *)newFrame 
tag:(int)newTag 

- renewFont:(const char *)newFontName 

size: (float )newFontSize 
style: (int) newFontStyle 
text: (const char *)newText 
frame’.(const NXRect *)newFrame 
tag:(int)newTag 

- renewRuns:(NXRunArray *)newRuns 

text: (const char *)newText 
frame:(const NXRect *)newFrcime 
tag:(int)newTag 

- windowChanged inewWindow 

Displaying 

- drawSelf:(const NXRect *)rects :(int )rectCount 

- setRetainedWhileDrawing: (B OOh)flag 

- (BOOL)isRetainedWhileDrawing 


Sets the gray value of the text background 
Returns the gray value of the text background 
Sets background color of the text 
Returns the background color of the text 
Sets the gray value of the selected text 
Returns the gray value of the selected text 
Returns the gray value for the specified text run 
Sets the color of the selected text 
Returns the color of the selected text 
Returns the color of the specified text run 
Sets the gray value of the entire text 
Returns the gray value of the entire text 
Sets the text color of the entire text 
Returns the text color of the draw entire text 


Resets Text object to draw different text 


Resets Text object to draw different text 


Resets Text object to draw different text 


Hides caret whenever the Text’s window changes 


Draws the Text object 

Allows use of retained window when drawing 
Returns whether retained window is used for drawing 
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Assigning a Tag 


- setTag:(int )anlnt 

- (int)tag 

Handling Event Messages 

- (BOOL)acceptsFirstResponder 

- becomeFirstResponder 

- resignFirstResponder 

- becomeKey Window 

- resignKeyWindow 

- mouseDown:(NXEvent *)theEvent 

- keyDown:(NXEvent *)theEvent 

- moveCaret: (unsigned short)f/ieXey 

Displaying Graphics within the Text 

+ registerDirective:(const char *) directive 
forClass:c/<zs , .s 

- replaceSelWithCellrce// 

- replaceSelWithView:v/ew 

- setLocation:(NXPoint *)origin 

oiCelhcell 

- getLocation:(NXPoint *)origin 

ofCel hcell 

- getLocation:(NXPoint *)origin 

ofView :vie\v 

- setGraphicsImportEnab!ed:(BOOL]/?ag 

- (BOOL)isGraphicsImportEnabled 


Makes anlnt the Text object’s tag 
Returns the Text object’s tag 


Returns whether receiver can be the first responder 
Informs Text object that it’s becoming first responder 
Stops being the first responder, if delegate agrees 
Activates caret if selection has width of 0 
Deactivates the caret 
Responds to mouse-down events 
Responds to key-down events 
Moves the caret in response to arrow keys 


Associates an RTF control word with a class object 

Replaces selection with image provided by cell 

Unimplemented 

Sets origin of cell 

Places coordinates of graphic object into origin 
Unimplemented 

Sets whether a Text object imports TIFF and EPS images 
Returns YES if the object imports TIFF and EPS images 


Using the Services Menu 

+ excludeFromServicesMenu:(BOOL)//ag Controls whether Text objects use services menu 

- validRequestorForSendType:(NXAtom),send7ype 

andReturnType:(NXAtom)retarn7y/?e Determines which Service menu items are enabled 

- readSelectionFromPasteboard:/?&oar<i Replaces selection with data from pboard 

- (BOOL)writeSelectionToPasteboard:/?/?oa/vi Copies selection to pboard 

types:(NXAtom *)types 
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Setting Tables and Functions 

- setCharFilter : (NXCharFilterFunc)aFwnc 

- (NXCharFilterFunc)charFilter 

- setTextFilter: (NXTextFilterFuncjaFwnc 

- (NXTextFilterFunc)textFilter 

- setBreakTable: (const NXFSM *)aTable 

- (const NXFSM *)breakTable 


Makes aFunc the character filter function 
Returns the current character filter function 
Makes aFunc the text filter function 
Returns the current text filter function 
Sets table defining word boundaries 
Gets table defining word boundaries 


- setPreSelSmartTable:(const unsigned char *)aTable 

Sets cut and paste table for left word boundary 

- (const unsigned char *)preSeISmartTable Gets cut and paste table for left word boundary 

- setPostSelSmartTable:(const unsigned char *)aTable 

Sets cut and paste table for right word boundary 

- (const unsigned char *)postSelSmartTable Gets cut and paste table for right word boundary 

- setCharCategoryTable:(const unsigned char *)aTable 

Sets table defining character categories 


- (const unsigned char *)charCategory Table 

- setClickTable: (const NXFSM *)aTable 

- (const NXFSM *)clickTable 

- setScanFunc:(NXTextFunc)aFimc 

- (NXTextFunc)scanFunc 

- setDrawFunc:(NXTextFunc)aFw«c 

- (NXTextFunc)drawF unc 


Returns table defining character categories 
Sets table defining double-click selection 
Gets table defining double-click selection 
Makes aFunc the scan function 
Returns the current scan function 
Makes aFunc the function that draws the text 
Returns the current draw function 


Printing 

- adjustPageHeightNew:(float *)newBottom Assists automatic pagination of text 

top: (float )oldTop 
bottom :(fioat )oldBottom 
limit: (float )bottomLimit 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 

Assigning a Delegate 

- setDelegat eianObject Makes anObject the Text object’s delegate 

- delegate Returns the Text object’s delegate 


Reads the Text object from the typed stream 
Writes the Text object to the typed stream 
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Implemented by the Delegate 

- textWillResize:se/ 2 ffer 

- textDidResize:se/jder 

oldBounds:(const NXRect *)oldBounds 
invalid:(NXRect *)invalidRect 

- (BOOLjtextWillChangeisender 

- textDidChangejsender 

- (B00L)textWillEnd:se/2c?er 

- textDidEnd:se/zder 

endChar:(unsigned short)whyEnd 

- textDidGetKeys: sender isEmpty:(BOOL)//ag 

- textWillSetSehse/z^er toFont:font 

- textWillConverLsezzzfer 

fromFont:/rom 

toFont:to 

- textWillStartReadingRichText : sender 

- textWillFinishReadingRichTextr^enJer 

- textWillWritezsenzfer 

paperSize:(NXSize *)paperSize 

- textI)idRead:.v£Hc/(?r 

paperSize:(NXSize *)paperSize 

Implemented by an Embedded Graphic Object 

- calcCellSize:(NXSize *)theSize 

- drawSelf:(const NXRect *)rect 

inView:vzevv 

- highlight:(const NXRect *)rect 

inYiewivzew 
lit: (BOOL )flag 

- readRichText:(NXStream *)strecim 

for View: v/evv 

- writeRichText:(NXStream *)stream 

forView:vzew 

- (BOOL)trackMouse:(NXEvent *)theEvent 

inRect: (const NXRect *)rect 
ofView :view 


Informs delegate of impending size change 
Reports size change to delegate 

Informs delegate of impending text change 
Alerts delegate to change in text 
Warns of impending loss of first responder status 
Reports to delegate loss of first responder status 

Informs delegate of each text change 

Lets delegate intercede in the updating of the Font panel 

Lets delegate intercede in selection’s font change 

Informs delegate that Text object will read RTF data 
Informs delegate that Text finished reading RTF data 
Lets the delegate specify paper size 

Lets the delegate review paper size 


Provides the size of the object 
Draws the object 

Highlights or unhighlights the object 

Reads representation from RTF data 
Writes RTF representation to stream 
Controls tracking of the mouse 
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TextField 


Inherits From: Control: View : Responder : Object 

Initializing the TextField Class 

+ setCelICIass:c/< 2 ss/<i Sets the Cell class used by TextField 


Inializing a new TextField 

- initFrame: (const NXRect *)frameRect Initializes a new TextField object with no text 


Enabling the TextField 

- setEnabled:(BOOL)/?flg 


Sets whether the TextField reacts to events 


Setting User Access to Text 

- setSeIectable:(BOOL)//a£ 

- (BOOL)isSelectable 

- setEditable:(BOOL)//a# 

- (BOOL)isEditable 


Sets whether the TextField’s text is selectable 
Returns whether the TextField’s text is selectable 
Sets whether the TextField’s text is editable 
Returns whether the TextField’s text is editable 


Editing Text 

- selectText'.sender 


Selects all of the text if it’s selectable or editable 


Setting Tab Key SsnSViCi 

- setNextText:anObject 

- nextText 

- setPreviousTextronOZyect 

- previousText 


Sets the object selected when the user presses Tab 
Sets the object selected when the user presses Tab 
Sets the object selected when the user types Shift-Tab 
Sets the object selected when the user types Shift-Tab 


Assigning a Text Delegate 

- setTextDelegatemnOZyecr 

- textDelegate 


Sets the delegate for messages from the field editor 
Returns the delegate for messages from field editor 
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Text Object Delegate Methods 

- (BOOL)textWillChange:teJt/OZ?/ecf 

- textDidGetKcysUextObject 

isEmpty:(BOOL )flag 

- textDidChange:tex/C>£yecr 

- (BOOL)textWillEnd:teJCtOZ?/ecr 

- texiDidEnditextObject 

endChar: (unsigned short) why End 

Modifying Graphic Attributes 

- setTextColor:(NXColor )aColor 

- (NXColor)textColor 

- setTextGray: (float) value 

- (float)textGray 

- setBackgroundColor:(NXColor)aCo/or 

- (NXColor)backgroundColor 

- setBackgroundGray:(float)va/ne 

- (float)backgroundGray 

- setBackgroundTransparent: (BOOL )flag 

- (BOOL)isBackgroundTransparent 

- setBezeled:(BOOL)/fag 

- (BOOL)isBezeled 

- setBordered:(BOOL)//ag 

- (BOOL)isBordered 

Target and Action 

- setErrorAction: (SEV)aSelector 

- (SEL)errorAction 

Resizing a TextField 

- sizeTo: (float) w/df/* :(float )height 

Handling Events 

- (BOOL)acceptsFirstResponder 

- mouseDown:(NXEvent *)theEvent 


Responds to a message from the field editor 
Responds to a message from the field editor 

Responds to a message from the field editor 
Responds to a message from the field editor 
Responds to a message from the field editor 


Sets the color of the TextField’s text to aColor 

Returns the color of the TextField’s text 

Sets the gray of the TextField’s text to value 

Returns the gray of the TextField’s text 

Sets the color of the background to aColor 

Returns the color of the background 

Sets the gray of the background to value 

Returns the gray of the background 

Sets whether the TextField background is transparent 

Returns whether the TextField background is transparent 

Sets whether the TextField has a bezeled border 

Returns whether the TextField has a bezeled border 

Sets whether the TextField has a plain border 

Returns whether the TextField has a plain border 


Sets the action method sent for an invalid value entered 
Returns the action method sent for an invalid value 


Resizes the TextField to width and height 


Returns YES if text is editable or selectable 
Responds to a mouse-down event 
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Archiving 


- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Reads the TextField from stream 
Writes the TextField to stream 


TextFieldCell 


Inherits From: ActionCell: Cell: Object 

Initializing a new TextFieldCell 
-init 

- initTextCell:(const char *)aString 

Copying a TextFieldCell 

- copyFromZone:(NXZone *)zone 

Modifying Graphic Attributes 

- setTextCoIor:(NXColor)aCo/or 

- (NXColor)textColor 

- setTextGray: (float) value 

- (float)textGray 

- setBackgroundColor:(NXColor)aCo/or 

- (NXColor)backgroundCoIor 

- setBackgroundGray:(float)va/w<? 

- (float)backgroundGray 

- setBackgroundTransparent: (BOOL)flag 

- (BOOL)isBackgroundTransparent 

- setTextAttributes:re;rt0&yect 

- setBezeled:(BOOL)/?«g 

- (BOOL)isOpaque 


Initializes a new TextFieldCell with text “Field” 
Initializes a new TextFieldCell with text aString 


Returns a copy of the TextFieldCell allocated from zone 


Sets the color of the text to aColor 
Returns the color of the text 
Sets the gray of the text to value 
Returns the gray of the text 
Sets the color of the background to aColor 
Returns the color of the background 
Sets the gray of the background to value 
Returns the gray of the background 
Sets whether the background is transparent 
Returns whether the background is transparent 
Sets the gray values of the background and text to those of 
textObject 

Sets whether TextFieldCell has a bezeled border 
Returns whether the cell is opaque 
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Displaying 

- drawSelf: (const NXRect *)cellFrame Draws the TextFieldCell 

in View icontrolView 

- drawlnside: (const NXRect *)cellFrame Draws the inside of the TextFieldCell 

inView :controlView 

Tracking the Mouse 

- (BOOL)trackMouse:(NXEvent *)theEvent Starts editing if possible 

inRect: (const NXRect *)aRect 
oiVievr.controlView 


Archiving 

- read:(NXTypedStream *) stream 

- write:(NXTypedStream *)stream 


Reads the TextFieldCell from stream 
Writes the TextFieldCell to stream 


View 


Inherits From: Responder : Object 

Initializing and Freeing View Objects 

- initFrame: (const NXRect *)frameRect 

- init 
-free 

Managing the View Hierarchy 

- addSubview:<zV7evv 

- addSubviewiflWew 

:(int )place 

relativeTo: otherView 

- fi nd A nces to r S h a red W i th:« View 

- (BOOL)isDescendantOf:aV?ew 

- opaqueAncestor 

- removeFromSuperview 


Initializes a new View object 
Initializes a new View object 
Deallocates the View and its subviews 


Makes aView a sub view of the receiving View 
Makes aView a subview of the receiving View 

Returns the ancestor shared by aView and the receiver 
Returns whether aView is an ancestor of the receiver 
Returns the receiver’s nearest opaque ancestor 
Removes the receiver from the view hierarchy 
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- replaceSubview:o/dVfew with inewView 

- subviews 

- superview 

- window 

- windowChangedmewWindow 

Modifying the Frame Rectangle 

- (float)frameAngle 

- getFrame:(NXRect *)theRect 

- moveBy:(NXCoord)c/e/toX :(NXCoord)deltaY 

- moveTo:(NXCoord)x :(NXCoord)y 

- rotateBy:(NXCoord)deltaAngle 

- rotateTo:(NXCoord)ang/e 

- setFrame:(const NXRect *)frameRect 

- sizeBy:(NXCoord)<ie/taWiV/?/z 

:(NX.Coord)deltaHeight 

- sizeTo:(NXCoord )width :(NXCoord )height 

Modifying the Coordinate System 

- (float)boundsAngle 

- drawInSuperview 

- getBounds:(NXRect *)theRect 

- (BOOL)isFlipped 

- (BOOL)isRotatedFromBase 

- (B OOL)isRotatedOrScaledFromBase 

- rotate:(NXCoord)angZe 

- setDrawRotation:(NXCoord)an^/<? 

- scale:(NXCoord)x :(NXCoord)y 

- setDrawSize:(NXCoord)w/dr/i :(NXCoord )height 

- translate:(NXCoord)x :(NXCoord)y 

- setDrawOrigin:(NXCoord)x :(NXCoord)y 

- setFlipped:(BOOL)//a£ 

Converting Coordinates 

- centerScanRect:(NXRect *)aRect 


Replaces oldView with newView 

Returns a List of the View’s subviews 

Returns the receiving View’s superview 

Returns the Window in which the View is displayed 

Notifies the View that the Window it’s in is changing 


Returns the angle of frame rectangle rotation 
Gets the View’s frame rectangle 
Moves the View by deltaX and deltaY 
Moves the View to (x, y) 

Rotates the View’s frame rectangle by deltaAngle 
Rotates the View’s frame rectangle to angle 
Assigns the View a new frame rectangle 
Resizes the View by deltaWidth and deltaHeight 

Resizes the View to width and height 


Returns the rotation of the View’s coordinate system 
Makes the View use its superview’s coordinate system 
Gets the View’s bounds rectangle 
Returns whether the View is flipped 
Returns whether the View is rotated 
Returns whether the View is rotated or scaled 
Rotates the View’s coordinate system by angle 
Rotates the View’s coordinate system to angle 
Scales the View’s coordinate system 

Resizes the View’s coordinate system to width and height 
Shifts the View’s coordinate system to (x, y) 

Sets the View’s origin to (x, y) 

Sets whether polarity of y-axis is reversed 


Converts the rectangle to lie on center of pixels 
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- convertPoint:(NXPoint *)aPoint 

from Vie wm View 

- convertPoint:(NXPoint *)aPoint toVievr.aViexv 

- convertPointFromSuperview:(NXPoint *)aPoint 

- convertPointToSuperview:(NXPoint *)aPoint 

- convertRect:(NXRect *)aRect from Viewm View 

- convertRect:(NXRect *)aRect toView:«V7ew 

- convertRectFromSuperview:(NXRect *)aRect 

- convertRectToSuperview:(NXRect *)aRect 

- convertSize:(NXSize *)aSize fromView:aView 

- convertSize:(NXSize *)aSize toView :aView 

Notifying Ancestor Views 

- descendantFlippechsender 

- descendantFrameChanged:sender 

- notifyAncestorWhenFrameChanged:(BOOL)/fog 


Converts the point to the receiver’s coordinates 

Converts the point to a View’s coordinates 

Converts the point to the receiver’s coordinates 
Converts the point to the superview’s coordinates 

Converts the rectangle to the receiver’s coordinates 
Converts the rectangle to aView's coordinates 
Converts the rectangle to the receiver’s coordinates 
Converts the rectangle to the superview’s coordinates 
Converts the size to the receiver’s coordinates 
Converts the size to aView's coordinates 


Notifies that sender's, y-axis has flipped 
Notifies that sender's, frame rectangle changed 


Sets whether to notify ancestors of frame change 

- notifyWhenFIipped:(BOOL)/?ag Sets whether to notify ancestors of flipped y-axis 

- suspendNotify AncestorWhenFrameChanged: (BOOL )jiag 

Starts/stops temporary suspension of ancestor notification 


Resizing Subviews 

- resizeSubviews:(const NXSize *)oldSize 

- setAutoresizeSubviews:(BOOL )flag 

- setAutosizing:(unsigned int )mask 

- (unsigned int)autosizing 

- superviewSizeChanged:(const NXSize *)oldSize 

Graphics State Objects 

- allocateGState 

- freeGState 

- (int)gState 

- initGState 

- renewGState 

- notifyTo!nitGState:(BOOL)/7ag 


Initiates superviewSizeChanged: messages 
Sets whether to notify subviews of resizing 
Determines automatic resizing behavior 
Returns the View’s autosizing mask 
Notifies subviews that superview changed size 


Allocates a graphics state object (when next focused upon) 
Frees the View’s graphics state object 
Returns the View’s graphics state object 
Initializes the View’s graphics state object 
Reinitializes the View’s graphics state object 
Determines whether initGState message is sent 
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Focusing 

- clipToFrame: (const NXRect *)frameRect 

- setClipping: (BOOL)flag 

- (BOOL)doesClip 

- (BOOL)isFocusView 

- (BOOL)lockFocus 

- unlockFocus 


Clips to the frame rectangle during focusing 
Sets whether the View is clipped to its frame rectangle 
Returns whether the View clips to its frame rectangle 
Returns whether the View is currently in focus 
Brings the View into focus 
Unfocuses the View 


Displaying 

- (BOOL)canDraw Returns whether the View can draw 

- display Displays the View and its subviews 

- display: (const NXRect *)rects :(int )rectCount Displays the View and its subviews 

- display: (const NXRect *)rects Displays the View and its subviews 

: (int) rect Count 
:(BOOL )c lip Flag 

- displayFromOpaqueAncestor:(const NXRect *)rects 

:(int)rectCount Displays underlying ancestors and the View 

:(BOOL )clipFlag 


- displaylfNeeded 

- drawSelf: (const NXRect *)rects :(int )rectCount 

- (BOOL)getVisibleRect: (NXRect *)theRect 

- (BOOL)isAutodisplay 

- setAutodisplay:(BOOL)/7flg 

- (BOOL)isOpaque 

- setOpaque:(BOOL)/fag 

- (BOOL)needsDisplay 

- setNeedsDisplay: (B OOL)flag 

- (BOOL)shouldDrawColor 

- update 

Scrolling 

- adjustScroll: (NXRect *)newVisible 

- autoscroll :(NXEvent *)theEvent 

- (BOOL)calcUpdateRects: (NXRect *)rects 

:(int *)rectCount 
: (NXRect *)enclRect 
: (NXRect *)goodRect 


Conditionally displays the View and its subviews 

Implemented by subclasses to supply drawing instructions 

Gets the View’s visible portion 

Returns whether the View automatically updates 

Determines whether update redisplays the View 

Returns whether the View is registered as opaque 

Registers the View as opaque 

Returns whether the View needs to be redisplayed 

Marks the View as changed, needing redisplay 

Returns whether the View should be drawn in color 

Conditionally redisplays the View 


Lets the View adjust the visible rectangle 
Scrolls in response to a mouse-dragged event 
Calculates the area to be redisplayed 
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- invalidate:(const NXRect *)rects :(int)rectCount 


- scrollPoint: (const NXPoint *)aPoint 

- scrollRect: (const NXRect *)aRect 

by:(const NXPoint *)delta 

- scrollRectToVisible: (const NXRect *)aRect 

- (float)backgroundGray 

Managing the Cursor 

- addCursorRect: (const NXRect *)aRect 

cursor :anObj 

- discardCursorRects 

- removeCursorRect: (const NXRect *)aRect 

cursor \anObj 

- resetCursorRects 


Marks parts of the View as needing to be redrawn 
Aligns aPoint with the content view’s origin 
Shifts the rectangle by delta 

Scrolls the View so the rectangle is visible 

Returns the View’s background gray (used by a 
Scroll View’s document view only) 


Adds a cursor rectangle to the View 

Removes all cursor rectangles in the View 
Removes a cursor rectangle from the View 

Resets the View’s cursor rectangles 


Assigning a Tag 

- findViewWithTag:(int)a7ag 

- (int)tag 


Returns the subview with aTag as its tag 
Returns the View’s tag 


Aiding Event Handling 

- (BOOL)acceptsFirstMouse Returns NO to refuse first mouse-down event 

- hitTest: (NXPoint *)aPoint Returns the lowest subview containing the point 

- (BOOL)mouse:(NXPoint *)aPoint Returns whether the point lies inside the rectangle 

inRect: (NXRect *)aRect 

- (BOOL)performKeyEquivalent:(NXEvent *)theEvent 

Returns whether a subview handled theEvent 

- (BOOL)shouldDelayWindowOrderingForEvent: (NXEvent *)anEvent 

Returns whether the View’s Window is brought forward 
normally (mouse-down) or delayed (mouse-up) 


Dragging 

- registerForDraggedTypes: (const char *const *)pbTypes count:(int)con«t 

Registers the Pasteboard types that the Window will accept 
in an image-dragging session 

- unregisterDraggedTypes Unregisters the Window as a recipient of dragged images 
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- draglmage:a«/wage Instigates an image-dragging session 

at:(NXPoint *) location 
offset:(NXPoint *)initialOjfset 
event: (NXE vent *)event 
pasteboard:(Pasteboard *)pboard 
source: source Object 
slideBack:(BOOL )slideFlag 

- dragFile:(const char *) filename Instigates a file-dragging session 

fromRect:(NXRect *)rect 
slideBack:(BOOL) aFlag 
event:(NXEvent *)event 


Printing 

- printPSCode : sender 

- faxPSCode^ender 

- faxPSCode:settcfer 

toList: (const char *const *)names 
numberList: (const char *const *)numbers 
sendAt:(time_t)r/me 
wantsCover: (BOOL)coverFlag 
wantsNotify:(BOOL )notijyFlag 
wantsHires:(BOOL)/i?rej , F/flg 
faxName: (const char *)string 

- copyPSCodeInside:(const NXRect *)rect 

to:(NXStream *)stream 

- writePSCodeInside:(const NXRect *)rect 

toipasteboard 

- openSpoolFile:(char *) filename 

- spoolFile: (const char *)filename 

- (BOOL)canPrintRIB 

Setting Up Pages 

- (BOOL)knowsPagesFirst:(int *)firstPageNum 

last:(int *)lastPageNum 

- (BOOL)getRect: (NXRect *)theRect 

forPage: (int)page 

- placePrintRect: (const NXRect *)aRect 

offset: (NXPoint *) location 

- (float)heightAdjustLimit 

- (float)widthAdjustLimit 


Prints the View and its subviews 
Faxes the View and its subviews 
Faxes the View and its subviews 


Generates PostScript code for the rectangle 

Places PostScript code for the rectangle on the pasteboard 

Opens filename for print spooling 

Spools filename to the printer 

Indicates whether the View can print RIB files 


Returns whether the View paginates itself 

Provides how much of the View will print on page 

Locates the printing rectangle on the page 

Returns how much of a page can go on the next page 
Returns how much of a page can go on the next page 
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Writing Conforming PostScript 

- beginPSOutput Initializes the printing environment 

- beginPrologueBBox: (const NXRect *)boundingBox 


creationDate: (const char *)dateCreated 
createdBy:(const char *)anApplication 
fonts:(const char *)fontNames 
forWhom:(const char *)user 
pages: (int)numPages 
title:(const char *)aTitle 

- endHeaderComments 

- endProIogue 

- beginSetup 

- endSetup 

- adjustPageWidthNew:(float *)newRight 

left: (float )oldLeft 
right:(float )oldRight 
limit:(float )rightLimit 

- adjustPageHeightNew:(float *)ne\vBottom 

top: (float )oldTop 
bottom: (float )oldBottom 
limit: (float )bottomLimit 

- beginPage:(int)ordinalNum 

label:(const char *)aString 
bBox:(const NXRect *)pageRect 
fonts:(const char *)fontNames 

- beginPageSetupRect:(const NXRect *)aRect 

placement:(const NXPoint *) location 

- drawSheetBorder:(float)wzV//7z:(float )height 

- drawPageB order: (float) wzV/r/z :(float )height 

- addToPageSetup 

- endPageSetup 
-endPage 

- beginTrailer 

- endTrailer 

- endPSOutput 

Archiving 

- awake 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Writes the beginning of the prologue for a print job 


Writes the end of the header 

Writes the end of the prologue 

Writes the beginning of the document setup section 

Writes the end of the document setup section 

Assists automatic pagination of the View 


Assists automatic pagination of the View 


Writes a page separator 


Writes the beginning of a page setup section 

Allows you to draw a sheet border 
Allows you to draw a page border 
Allows you to add scaling to PostScript code 
Writes the end of a page setup section 
Writes the end of a page 

Writes the beginning of the trailer for the print job 
Writes the end of the trailer 
Finishes the printing job 


Initializes the View after reading 
Reads the View from the typed stream 
Writes the View to the typed stream 
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Window 


Inherits From: Responder : Object 

Initializing a New Window Object 

- init 

- initContent:(const NXRect *)contentRect 

style :(int)aStyle 
backing:(ini)bufferingType 
buttonMask: (int)mask 
defer: (BOOL )flag 

- initContent:(const NXRect *)contentRect 

style:(int )aStyle 

backing: (mt)bujfering Type 

buttonMask: (mt)mask 

defer: (B OOL)flag 

screen:(const NXScreen *)aScreen 

Freeing a Window Object 

- free 

Computing Frame and Content Rectangles 

+ getFrameRect:(NXRect *)frame 

forContentRect:(const NXRect *)content 
style :(int )aStyle 

+ getContentRect:(NXRect *)content 

forFrameRect:(const NXRect *)frame 
style :(int)aStyle 

+ (NXCoord)minFrame Width: (const char *)aTitle 
forStyle:(int)aStyle 
buttonMask: (i nt)aMosk 

Accessing the Frame Rectangle 

- getFrame: (NXRect *)theRect 

- getFrame:(NXRect *)theRect 

andScreen:(const NXScreen **)theScreen 


Initializes the new Window with default parameters 
Initializes the new Window object as specified 


Initializes the new Window object for screen as specified 


Frees the Window object and its Views 


Gets frame rectangle for given content rectangle 

Gets content rectangle for given frame rectangle 


Returns minimum frame width needed for aTitle 


Gets the Window’s frame rectangle 

Gets the Window’s frame rectangle and screen 
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- (BOOL)setFrameUsingName:(const char *)name 

Sets the frame rectangle from the named default 

- (void)saveFrameUsingName:(const char *)name Saves the frame rectangle as a system default 

+ (void)removeFrameUsingName: (const char *)name 

Removes the named frame data from the system defaults 

- (BOOL)setFrameAutosaveName: (const char *)name 


- (const char *)frameAutosaveName 

- (void)setFrameFromString:(const char *)string 

- saveFrameToString:(const char *)string 

Accessing the Content View 

- setContentVievv:aWevv 

- contentView 

Querying Window Attributes 

- (int)windowNum 

- (int)buttonMask 

- (int)style 

- (BOOL)worksWhenModal 

Window Graphics 

- setTitle:(const char *)aString 

- setTitleAsFilename: (const char *)aString 

- (const char *)title 

-setBackgroundColor:(NXColor)co/or 

- (NXColor)backgroundColor 

- setBackgroundGray:(float)vfl/ne 

- (float)backgroundGray 

Window Device Attributes 

- setBackingType:(int)feflc/:mg 

- (int)backingType 

- setOneShot:(BOOL)//ag 


Sets the name that’s used to autosave the frame rectangle as 
a system default 

Returns the name that’s used to autosave the frame 
rectangle as a system default 

Sets the frame rectangle from string 
Saves the frame rectangle data to string 


Makes aView the Window’s content view 
Returns the Window’s content view 


Returns the window number 
Returns the mask identifying Window controls 
Returns the Window’s border and title bar style 
Returns NO 


Makes aString the Window’s title 

Formats aString and makes it the Window’s title 

Returns the Window’s title string 

Sets the Window’s background color to color 

Returns the Window’s background color 

Sets the gray value for Window’s background gray 

Returns the Window’s background gray 


Sets the type of window device backing 

Returns the window device backing type 

Sets whether memory for the window should be freed 
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- (BOOL)isOneShot 

- setFreeWhenClosed:(BOOL)/?ag 

Graphics State Objects 

- (int)gState 

The Miniwindow 

- counterpart 

- setMiniwindowIcon:(const char *)name 

- (const char *)miniwindowIcon 

- setMiniwindowImage:/mag<? 

- (NXImage *)miniwindowImage 

- setMiniwindowTitle:(const char *)title 

- (const char *)miniwindowTitIe 

The Field Editor 

- getFie!dEditor:(BOOL]/?ag ior:anObject 

- endEditingFor:anObject 

Window Status 

- makeKey Window 

- makeKeyAndOrderFronhsender 

- becomeKeyWindow 

- (BOOL)isKey Window 

- resignKey Window 

- (BOOL)canBecomeKeyWindow 

- becomeMainWindow 

- (BOOL)isMainWindow 

- resignMain Window 

- (BOOL)canBecomeMain Window 

Moving and Resizing the Window 

- moveTo:(NXCoord)jt :(NXCoord)y 

- moveTo:(NXCoord)r 

:(NXCoord)y 

screen:(const NXScreen *)aScreen 


Returns whether memory for the window is freed 
Sets whether closing the Window also frees it 


Returns the graphics state object for the Window 


Returns the receiver’s mini windowAVindow companion 
Sets the icon that’s displayed in the miniwindow 
Returns the icon that’s displayed in the mini window 
Sets the image that’s displayed in the miniwindow 
Returns the image that’s displayed in the miniwindow 
Sets the title that’s displayed in the miniwindow 
Sets the title that’s displayed in the miniwindow 


Returns the Window’s field editor 
Ends the field editor’s editing assignment 


Makes the receiver the key window 
Makes Window the key window and brings it forward 
Records Window’s new status as the key window 
Returns whether Window is the key window 
Records that Window no longer is the key window 
Returns whether Window can be the key window 
Records Window’s new status as the main window 
Returns whether Window is the main window 
Records that Window no longer is the main window 
Returns whether Window can be the main window 


Moves the Window to (jc, y) 

Moves the Window to (jc, y) relative to aScreen 
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- moveTopLeftTo:(NXCoord)x :(NXCoord)y Moves top left corner of the Window to (x, y) 

- moveTopLeftTo:(NXCoord)jc Moves top left corner of the Window relative to aScreen 

:(NXCoord )y 

screen: (const NXScreen *)aScreen 

- dragFrom:(float)jc :(float)}’ eventNum:(int)m*m Lets user drag the Window from (x, y ) 

- constrainFrameRect:(NXRect *)frameRect Constrains the Window to screen 

toScreen:(const NXScreen *)screen 

- placeWindow:(const NXRect *)fra?neRect Resizes the Window to new frame rectangle 

- placeWindow:(const NXRect *)frameRect Resizes the Window relative to aScreen 

screen:(const NXScreen *)aScreen 

- place Window AndDisplay:(const NXRect *)frameRect 

Resizes the Window while redisplaying its Views 

- sizeWindow:(NXCoord )width :(NXCoord)height 


- center 

- setMinSize:(const NXSize *)aSize 

- getMinSize:(NXSize *)aSize 

- setMaxSize: (const NXSize *)aSize 

- getMaxSize:(NXSize *)aSize 

- (int)resizeFlags 

Reordering the Window 

- makeKeyAndOrderFrontrsender 

- orderFrontrse/ider 

- orderBack: sender 

- orderOut '.sender 

- orderWindow:(int)/)/<3c<? relativeTo:(int)or/ierWm 

- orderFrontRegardless 

- (BOOL)is Visible 

- setHideOnDeactivate:(BOOL)//ag 

- (BOOL)doesHideOnDeactivate 

Converting Coordinates 

- convertBaseToScreen:(NXPoint *)aPoi?it 

- convertScreenToBase:(NXPoint *)aPoint 


Resizes the Window’s content area 
Centers the Window on the screen 
Sets the Window’s minimum size 
Returns the Window’s minimum size 
Sets the Window’s maximum size 
Returns the Window’s maximum size 
Returns the event flags during resizing 


Makes the Window the key window and brings it forward 
Puts the Window at the front of its tier 
Puts the Window at the back of its tier 
Removes the Window from the screen list 

Repositions the Window in screen list 
Puts the Window at the front even if the application is 
inactive 

Returns whether the Window is in the screen list 
Sets whether deactivation hides the Window 
Returns whether deactivation hides the Window 


Converts point from base to screen coordinates 
Converts point from screen to base coordinates 
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Managing the Display 

- display 

- displaylfNeeded 

- disableDisplay 

- (BOOL)isDisplayEnabled 

- reenableDisplay 

- flushWindow 

- flushWindowIfNeeded 

- disableFlush Window 

- reenableFIush Window 

- (BOOL)isFlushWindowDisabled 

- displayBorder 

- useOptimizedDrawing:(BOOL)/7ag 

- update 

Screens and Window Depths 

- (const NXScreen *)screen 

- (const NXScreen *)bestScreen 

+ (NXWindowDepth)defaultDepthLimit 

- setDepthLimit:(NXWindowDepth)//#mf 

- (NXWindowDepth)depthLimit 

- setDynamicDepthLimit:(BOOL)/?ag 

- (BOOL)hasDynamicDepthLimit 

- (BOOL)canStoreCoIor 

Cursor Management 

- addCursorRect:(const NXRect *)aRect 

cursor :anObject 
forView.vzV/'cvv 

- removeCursorRect:(const NXRect *)aRect 

cursor: anObject 
forView :aView 

-invalidateCursorRectsForViewraV/evv 

- disableCursorRects 

- enableCursorRects 

- discardCursorRects 

- resetCursorRects 


Displays all the Window’s Views 

Displays all the Window’s Views that need it 

Inhibits Views from drawing in the Window 

Returns whether Views can draw in the Window 

Reenables drawing by Views in the Window 

Flushes the Window’s buffer to the screen 

Conditionally flushes the Window’s buffer to the screen 

Disables flushing for a buffered Window 

Reenables flushing for a buffered Window 

Returns whether flushing is disabled 

Displays the border and title bar 

Sets whether Window’s Views should optimize drawing 

Implemented by subclasses (see Menu) 


Returns the screen that (most of) the Window is on 
Returns the deepest screen that the Window is on 
Returns the maximum depth for the current context 
Sets the Window’s depth limit to limit 
Returns the Window’s depth limit 
Sets whether the depth limit will depend on the screen 
Returns whether the depth limit depends on the screen 
Returns whether Window is deep enough to store colors 


Adds a new cursor rectangle to the Window 

Removes a cursor rectangle from the Window 

Marks cursor rectangles invalid for aView 
Disables all cursor rectangles in the Window 
Enables cursor rectangles in the Window 
Removes all cursor rectangles in the Window 
Resets cursor rectangles for the Window 
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Handling User Actions and Events 

- close 

- performClose: sender 

- miniaturizersender 

- performMiniaturize:sender 

- deminiaturizeisender 

- setDocEdited:(BOOL)/fog 

- (BOOL)isDocEdited 

- windowExposed:(NXEvent *)theEvent 

- windo\vMoved:(NXEvent *)theEvent 

- screenChanged:(NXEvent *)theEvent 

Setting the Event Mask 

- (int)setEventMask:(int)newMnsA: 

- (int)addToEventMask:(int)nevv£ve/t/s 

- (int)removeFromEventMask:(int)6>/d/ivenrs' 

- (int)eventMask 

Aiding Event Handling 

- getMouseLocation:(NXPoint *)thePoint 

- setTrackingRect:(const NXRect *)aRect 

inside:(BOOL )insideFlag 
owner lanObject 
tag: (mt)trackNum 
left:(BOOL )leftDown 
right:(BOOL)rightDown 

- discardTrackingRect:(int)tracfoVz/m 

- makeFirstResponder:aRes/7onder 

- firstResponder 

- sendEvent:(NXEvent *)theEvent 

- rightMouseDown:(NXEvent *)theEvent 

- (BOOL)commandKey:(NXEvent *)theEvent 

- (BOOL)tryToPerform:(SEL)er/zAcdo7i 

with lanObject 

- set Avoids Activation: ( BOOL)flag 

- (BOOL)avoidsActivation 


Closes the Window 

Simulates user clicking the close button 
Hides the Window and displays its miniwindow 
Simulates user clicking the miniaturize button 
Hides the miniwindow and redisplays the Window 
Sets whether the Window’s document has been edited 
Returns whether Window’s document has been edited 
Redisplays exposed part of the Window 
Updates the frame rectangle 

Adjusts depth limit of Windows with a dynamic limit 


Sets the Window’s event mask to newMask 
Adds newEvents to the event mask 
Removes oldEvents from the event mask 
Returns the Window’s event mask 


Provides current location of the cursor 
Sets a tracking rectangle within the Window 


Clears tracking rectangle within the Window 
Makes aResponder the first responder 
Returns the first responder 
Dispatches mouse and keyboard events 
Handles right mouse-down events 
Handles Command key-down events 
Aids in dispatching action messages 

Establishes whether the application will become active 
when the user clicks in the Window 

Returns the value set by set Avoids Activation: 
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Dragging 


- registerForDraggedTypes:(const char *const *)pbTypes count: (\ni)count 

Registers the Pasteboard types that the Window will accept 
in an image-dragging session 

- unregisterDraggedTypes Unregisters the Window as a recipient of dragged images 

- draglmage:a«/mage Instigates an image-dragging session 

at:(NXPoint *) location 
offset:(NXPoint *)initialOffset 
event:(NXEvent *)event 
pasteboard:(Pasteboard *)pboard 
source \sourceObject 
slideBack:(BOOL)s/jWeF/0g 


Services and Windows Menu Support 

- validRequestorForSendType:(NXAtom)/y/?<?Seftt 

andReturnType:(NXAtom)rypei?etMrneJ 

- setExcludedFrom Windo wsMenu: (BOOL )flag 

- (BOOL)isExcludedFromWindowsMenu 

Printing 

- printPSCode '.sender 

- smartPrintPSCodersender 

- faxPSCode:sender 

- smartFaxPSCode:s<?nder 

- openSpoolFile:(char *)filename 

- spoolFile:(const char *)filename 

- copyPSCodeInside:(const NXRect *)rect 

to:(NXStream *)stream 

- (BOOL)knowsPagesFirst:(int *)firstPageNnm 

last:(int *)lastPageNum 

- (BOOL)getRect:(NXRect *)theRect 

forPage: (int )page 

- placePrintRect:(const NXRect *)aRect 

offset:(NXPoint *) location 

- (float)heightAdjustLimit 

- (float)widthAdjustLimit 

- beginPSOutput 


Invoked by clicking a Services menu item 

Sets whether Window is left out of the Windows menu 
Returns whether Window is left out of Windows menu 


Prints all the Window’s Views 

Prints all the Window’s Views 

Faxes all the Window’s Views 

Faxes all the Window’s Views 

Opens filename for print spooling 

Spools filename to the printer 

Writes PostScript code for the rectangle to stream 

Returns whether the Window paginates itself 

Provides how much of the Window fits on page 

Locates the printing rectangle on the page 

Returns how much of a page can go on next page 
Returns how much of a page can go on next page 
Initializes the printing environment 
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- beginPrologueBBox:(const NXRect *)boundingBox 


creationDate:(const char *)dateCreated 
createdBy: (const char *)anApplication 
fonts:(const char *)fontNames 
forWhom:(const char *)user 
pages :(int )numPages 
title:(const char *)aTitle 

- endHeaderComments 

- endPrologue 

- beginSetup 

- endSetup 

- begiriPage:(ini)ordinalNum 

label:(const char *)aString 
bBox:(const NXRect *)pageRect 
fonts:(const char *)fontNames 

- beginPageSetupRect:(const NXRect *)aRect 

placement: (const NXPoint *) location 

- endPageSetup 

- endPage 

- beginTrailer 

- endTrailer 

- endPSOutput 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 

- awake 

Assigning a Delegate 

- setDelegat e:anObject 

- delegate 

Implemented by the Delegate 

- windowWillClose:serc der 

- windowWillReturnFieldEditonse/ifife/* 

toObject '.client 

- windowWillResize:send<?r 

toSize:(NXSize *)frameSize 


Writes the beginning of the prologue for a print job 


Writes the end of a PostScript comment section 
Writes the end of the prologue 
Writes the beginning of the document setup section 
Writes the end of the document setup section 
Writes a page separator 


Writes the beginning of a page setup section 

Writes the end of a page setup section 
Writes the end of a page description 
Writes the beginning of trailer for the print job 
Writes the end of the trailer 
Finishes the printing job 


Reads the Window from the typed stream 
Writes the Window to the typed stream 
Redisplays and reinitializes the Window 


Makes anObject the Window’s delegate 
Returns the Window’s delegate 


Notifies delegate that the Window is about to close 
Lets delegate provide another Text object 

Lets delegate constrain resizing 
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- windowDidResizetjencfer 

- windo wDid Exp os e: sen der 

- windowWillMoversemfer 

- windowDidMove:sen<ier 

- windowDidChangeScreenrse/nier 

- windowDidBecomeKey:sender 

- windo wDidResignKey render 

- windowDidBecomeMain render 

- windowDidResignMain:serafer 

- windo wWillMiniaturize render 

toMini\vmdo\v :miniwindow 

- windowDidMiniaturizersenefer 

- windowDid Demini a turize:sYvzJer 

- windowDidUpdate:se«der 


Notifies delegate that the Window was resized 
Notifies delegate that the Window was exposed 
Notifies delegate that the Window will move 
Notifies delegate that the Window did move 
Notifies delegate that the Window changed screens 
Notifies delegate that the Window is the key window 
Notifies delegate that the Window isn’t the key window 
Notifies delegate that the Window is the main window 
Notifies delegate that the Window isn’t the main window 
Notifies delegate that the Window will miniaturized 

Notifies delegate that the Window was miniaturized 
Notifies delegate that the Window was restored to screen 
Notifies delegate that the Window was updated 
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Protocols 


NXDraggingDestination 


Adopted By: no NeXTSTEP classes 


Before the Image is Released 

- (NXDragOperation)draggingEntered:(id <NXDraggingInfo>)sender 

Invoked when the dragged image enters the destination 

- (NXDragOperation)draggingUpdated:(id <NXDraggingInfo>)^enJ(?r 

Invoked periodically while the image is over the destination 

- draggingExited:(id <NXDraggingInfo>).sender Invoked when the dragged image exits the destination 

After the Image is Released 

- (BOOL)prepareForDragOperation:(id <NXDraggingInfo>)5end r er 

Invoked when the image is released 

- (BOOL)performDragOperation:(id <NXDraggingInfo >)sender 

Gives the destination an opportunity to perform the 
dragging operation 

- concludeDragOperation:(id <NXDraggingInfo>)sender 

Invoked when the dragging operation is complete. 


NXDragginglnfo 


Adopted By: no NeXTSTEP classes 


Dragging-Session Information 

- (BOOL)isDraggingSourceLocal Returns whether the source and destination are in the same 

application 

- draggingSource Returns the source of the dragged image 
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- (NXDragOperation)draggingSourceOperationMask 


- draggingDestination Window 

- (Pasteboard *)draggingPasteboard 

- (int)draggingSequenceNumber 

- (NXPoint)draggingLocation 

Image Information 

- (NXImage *)draggedlmage 

- (NXImage *)draggedImageCopy 

- (NXPoint)draggedlmageLocation 

Sliding the Image 

- slideDraggedImageTo:(NXPoint *)screenPoint 


Returns the operation mask declared by the source 
Returns the destination’s Window 
Returns the Pasteboard that holds the dragged data 
Returns a number that identifies the dragging session 
Returns the cursor’s location 


Returns the NXImage object that’s being dragged 
Returns a copy of the NXImage object that’s being dragged 
Returns the current location of the dragged image’s origin 


Slides the image to the given location in the screen 
coordinate system 


IMXDraggingSource 

(informal protocol) 


Category Of: Object 


Querying the Source 

-(NXDragOperation)draggingSourceOperationMaskF orLocal: (B OOL )isLocal 

Returns a mask giving the operations that can be performed 
on the dragged image’s data 


Informing the Source 

- draggedlmage: (NXImage *)image 

beganAt:(NXPoint *)screenPoint 

- draggedlmage: (NXImage *)image 

endedAt:(NXPoint *)screenPoint 
deposited: (BOOL )didDeposit 


Invoked when the dragged image is displayed but before it 
starts following the mouse 

Invoked after the dragged image has been released and the 
dragging destination has been given a chance to operate 
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NXNibNotification 

(informal protocol) 

Category Of: Object 

Response on Loading 
- awakeFromNib 


NXPrintingUserlnterface 

(informal protocol) 

Category Of: Object 

Printer Panel 

- (BOOL)shouldRunPrintPanel:aVtew 

NXRTFDErrorHandler 

Adopted By: No NeXTSTEP Classes 

Notification of Overwrite 

- (BOOL)attemptOverwrite: (const char *)filename 


Implemented to respond to notifications sent after objects 
have been loaded from a nib file 


Implemented to indicate whether the Print panel (or Fax 
panel) should be displayed to the user 


Notifies the receiver that the user is attempting to save an 
RTFD document in a location for which the user doesn’t 
have search permission 
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NXServicesRequests 

(informal protocol) 

Category Of: Object 

Pasteboard Read/Write 

- readSelectionFromPasteboard:/?& 0 ard Implemented to replace selection with data from pboard 

- (BOOL)writeSelectionToPasteboard:/?6oard types:(NXAtom *)types 

Implemented to write the selection to pboard as types data 
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Application Kit Functions 


Rectangle Functions 


Modify a rectangle: 

void NXSetRect(NXRect *aRect, NXCoord x, NXCoord y, NXCoord width, 

NXCoord height) 

void NXOffsetRect(NXRect *aRect, NXCoord dx, NXCoord dy) 

void NXInsetRect(NXRect *aRect, NXCoord dx, NXCoord dy) 

void NXIntegralRect(NXRect *aRect) 

NXRect * NXDivideRect(NXRect *aRect, NXRect *bRect, NXCoord slice, int edge) 

Test graphic relationships: 

BOOL NXMouseInRect(const NXPoint *aPoint, const NXRect *aRect, BOOL flipped) 

BOOL NXPointInRect(const NXPoint *aPoint, const NXRect *aRect) 

BOOL NXIntersectsRect(const NXRect *aRect, const NXRect *bRect) 

BOOL NXContainsRect(const NXRect *aRect, const NXRect *bRect) 

BOOL NXEqualRect(const NXRect *aRect, const NXRect *bRect) 

BOOL NXEmptyRect(const NXRect *aRecf) 


Compute third rectangle from two rectangles: 

NXRect * NXUnionRect(const NXRect *aRect, NXRect *bRect) 

NXRect * NXIntersectionRect(const NXRect *aRect, NXRect *bRect) 

Optimize drawing: 

void NXRectClip(const NXRect *aRect) 

void NXRectClipList(const NXRect *rects, int count) 

void NXRectFill(const NXRect *aRect) 

void NXRectFillList(const NXRect *rects, int count) 

void NXRectFillListWithGrays(const NXRect *rects, const float * grays, int count) 

void NXEraseRect(const NXRect *aRect) 

void NXHighIightRect(const NXRect *aRect) 


Draw a bordered rectangle: 

void NXDrawButton(const NXRect *aRect, const NXRect *clipRect) 

void NXDrawGrayBezel(const NXRect *aRect, const NXRect *clipRect) 
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void 

void 

NXRect * 

void 

void 


NXDrawGroove(const NXRect *aRect, const NXRect *clipRect) 
NXDrawWhiteBezeI(const NXRect *aRect, const NXRect *clipRect ) 
NXDrawTiIedRects(NXRect *boundsRect, const NXRect *clipRect, 
const int * sides, const float * grays, int count) 
NXFrameRect(const NXRect *aRect) 

NXFrameRectWithWidth(const NXRect *aRect, NXCoord frameWidth ) 


Query an NXRect structure: 

NXCoord NX_X(NXRect *aReci) 

NXCoord NX_Y(NXRect *aRect) 

NXCoord NX_WIDTH(NXRect *aRect) 

NXCoord NX_HEIGHT(NXRect *aRect) 

NXCoord NX_MAXX(NXRect *aRect) 

NXCoord NX_MAXY(NXRect *aRect) 

NXCoord NX_MIDX(NXRect *aRect) 

NXCoord NX_MIDY(NXRect *aRect) 


Color Functions 


Specify a color value: 


NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 


NXConvertRGBAToColor(float red, float green, float blue, float alpha) 
NXConvertCMYKAToCoIor(float cyan, float magenta, float yellow, float black, 
float alpha) 

NXConvertHSBAToColor(float hue, float saturation, float brightness, float alpha ) 
NXConvertGrayAlphaToColor(float gray, float alpha) 
NXConvertRGBToCoIor(float red, float green, float blue) 
NXConvcrtCMYKToColor(float cyan, float magenta, float yellow, float black) 
NXConvertHSBToColor(float hue, float saturation, float brightness) 
NXConvertGrayToColor(float gray) 


Convert a color value to its standard components: 

void NXConvertColorToRGBA(NXColor color, float *red, float * green, float *blue, 

float * alpha) 

void NXConvertCoIorToCMYKA(NXColor color, float *cyan, float *magenta, 

float *yellow, float *black, float *alpha) 

void NXConvertCoIorToHSBA(NXColor color, float *hue, float * saturation, 

float * brightness, float *alpha) 

void NXConvertCoIorToGrayAlpha(NXColor color, float *gray, float *alpha) 

void NXConvertColorToRGB(NXColor color, float *red, float * green, float *blue) 
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void 


NXConvertColorToCMYK(NXColor color, float *cyan, float *magenta, 
float *yellow, float *black) 
void NXConvertColorToHSB(NXColor color, float *hue, float * saturation, 

float * brightness) 

void NXConvertColorToGray(NXColor color, float *gray) 


Modify a color by changing one of its components: 


NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 

NXColor 


NXChangeRedComponent(NXColor color, float red) 
NXChangeGreenComponent(NXColor color, float green) 
NXChangeBlueComponent(NXColor color, float blue) 
NXChangeCyanComponent(NXColor color, float cyan) 
NXChangeMagentaComponent(NXColor color, float magenta) 
NXChangeYellowComponent(NXColor color, float yellow) 
NXChangeBlackComponent(NXColor color, float black) 
NXChangeHueComponent(NXColor color, float hue) 
NXChangeSaturationComponent(NXColor color, float saturation) 
NXChangeBrightnessComponent(NXColor color, float brightness) 
NXChangeGrayComponent(NXColor color, float gray) 
NXChangeAlphaComponent(NXColor color, float alpha) 


Isolate one component of a color: 


float 

NXRedComponent(NXColor color) 

float 

NXGreenComponent(NXColor color) 

float 

NXBlueComponent(NXColor color) 

float 

NXCyanComponent(NXColor color) 

float 

NXMagentaComponent(NXColor color) 

float 

NXYellowComponent(NXColor color) 

float 

NXBlackComponent(NXColor color) 

float 

NXHueComponent(NXColor color) 

float 

NXSaturationComponent(NXColor color) 

float 

NXBrightnessComponent(NXColor color) 

float 

NXGrayComponent(NXColor color) 

float 

NXAlphaComponent(NXColor color) 


Test whether two colors are the same: 

BOOL NXEqualColor(NXColor oneColor, NXColor anotherColor) 

Get information about color space and window depth: 

NXColorSpace NXColorSpaceFromDepth(NXWindowDepth depth) 
int NXBPSFromDepth(NXWindowDepth depth) 


Application Kit Functions 
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int NXNumberOfColorComponents(NXColorSpace space ) 

BOOL NXGetBestDepth(NXWindowDepth *depth, int numColors, int bps) 

Read and write a color from a typed stream: 

NXColor NXReadColor(NXTypedStream * stream ) 

void NXWriteColor(NXTypedStream * stream, NXColor color) 

Read and write a color from a pasteboard: 

NXColor NXReadColorFromPasteboard(id pasteboard) 

void NXWriteColorToPasteboard(id pasteboard, NXColor color) 

Set the current color: 

void NXSetCoIor(NXColor color) 

Reading the color at a screen position: 

NXColor NXReadPixel(const NXPoint * location) 

Associate named colors with their color lists 

const char * NXColorListName (NXColor color) 

const char * NXColorName (NXColor color) 

BOOL NXFindColorNamed (const char *colorList, const char *colorName, 

NXColor *color) 


Text Functions 


Filter characters entered into Text object: 

unsigned short NXFieldFilter(unsigned short theChar, int flags, unsigned short charSet) 

unsigned short NXEditorFilter(unsigned short theChar, int flags, unsigned short charSet) 

Calculate or draw a line of text (in Text object): 

int NXScanALine(id self, NXLaylnfo *layInfo) 

int NXDrawALine(id self, NXLaylnfo *layInfo) 
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Calculate font ascender, descender, and line height (in Text object): 

void NXTextFontInfo(id/<?nf/<i, NXCoord * ascender, NXCoord * descender, 

NXCoord *lineHeight) 


Access Text object's word tables: 

void NXReadWordTable(NXZone *zone, NXStream * stream, 

unsigned char **preSelSmart, 
unsigned char **postSelSmart, 

unsigned char **charCategories, NXFSM **wrapBreaks, 
int *wrapBreaksCount, NXFSM **clickBreaks, 
int *clickBreaksCount, BOOL *charWrap) 

void NXWriteWordTable(NXStream * stream, const unsigned char *preSelSmart, 

const unsigned char *postSelSmart, 
const unsigned char *charCategories, 
const NXFSM *wrapBreaks, int wrapBreaksCount, 
const NXFSM *clickBreaks, int clickBreaksCount, 

BOOL charWrap ) 


Provide table-driven string ordering service: 

int NXOrderStrings(const unsigned char *string 1, const unsigned char *string2, 

BOOL caseSensitive, int length, NXStringOrderTable *table) 
NXStringOrderTable * NXDefaultStringOrderTable(void) 


Imaging Functions 


Copy an image: 

void NXCopyBits(int gstate, const NXRect *aRect, const NXPoint *aPoint) 

void NXCopyBitmapFromGstate(int gstate, const NXRect *srcRect, 

const NXRect *destRect) 


Render and read bitmap images: 

void NXDrawBitmap(const NXRect *rect, int pixelsWide, int pixelsHigh, int bps, 

int spp, int config, int mask, const void *datal, const void *data2, 
constvoid*c?ata3, constvoid* data4, const void *data5) 
void NXReadBitmap(const NXRect *rect, int pixelsWide, int pixelsHigh, int bps, 

int spp, int config, int mask, void *datal, void *data2, 
void *data3, void *data4, void *data5) 
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void NXSizeBitmap(const NXRect *rect, int *size, int *pixelsWide, int *pixelsHigh, 

int *bps, int *spp, int *config, int *mask ) 


Object Management Functions 

Refer to objects by name: 

id NXGetNamedObject(const char *name, id owner) 

const char * NXGetObjectName(id theObject ) 

int NXNameObject(const char *name, id theObject, id owner ) 

int NXUnnameObject(const char *name, id owner) 

Get information about an application's windows: 

void NXCountWindows(int *count) 

void NXWindowList(int size, int list[]) 

Convert local and global window numbers: 

void NXConvertWinNumToGlobal(int winNum, unsigned int *globalNum) 

void NXConvertGlobalToWinNum(int globalNum, unsigned int *winNum) 

Set up a pop-up list: 

void NXAttachPopUpList(id button, PopUpList *popUpList) 

id NXCreatePopUpListButton(PopUpList *popUpList) 

Create or free an attention panel: 

int NXRunAlertPanel(const char title, const char *msg, const char *defaultButton, 

const char *alternateButton, const char *otherButton ,...) 
int NXRunLocalizedAlertPanel(const char *table, const char *title, const char *msg, 

const char *defaultButton, const char * alternate Button, 
const char *otherButton, ...) 

id NXGetAlertPaneI(const char * title, const char *msg, const char *firstButton, 

const char *alternateButton, const char *otherButton ,...) 
void NXFreeAlertPaneI(id alertPanel ) 
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Error-Handling Functions 


Set and return an error handler: 

void NXDefaultTopLevelErrorHandler(NXHandler *errorState) 

NXTopLevelErrorHandler * NXSetTopLevelErrorHandler(NXTopLevelErrorHandler *proc) 

/* a macro */ 

NXTopLevelErrorHandler * NXTopLevelErrorHandler(void) /* a macro */ 

Manage error reporting: 

void NXRegisterErrorReporter(int min, int max, NXErrorReporter *proc ) 

void NXRemoveErrorReporter(int code) 

void NXReportError(NXHandler *errorState) 

Write a formatted error string: 

void NXLogError(const char * format,...) 


Typed Stream Functions 


Read or write NeXT-defined data types from or to a typed stream: 

void NXReadPoint(NXTypedStream *typedStream, NXPoint *aPoint) 

void NXWritePoint(NXTypedStream *typedStream, const NXPoint *aPoint) 

void NXReadSize(NXTypedStream *typedStream, NXSize *aSize) 

void NXWriteSize(NXTypedStream *typedStream, const NXSize *aSize) 

void NXReadRect(NXTypedStream *typedStream, NXRect *aRect) 

void NXWriteRect(NXTypedStream *typedStream, const NXRect *aRect) 


Remote Messaging Functions 


Save data received in a remote message: 

char * NXCopyInputData(int parameter) 

char * NXCopyOutputData(int parameter) 
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Get send rights to an application port: 

port_t NXPortFromName(const char *name, const char *host) 

port_t NXPortNameLookup(const char *name, const char *host) 


Match an Objective-C method and a receiver to a remote message: 

NXRemoteMethod * NXRemoteMethodFromSel(SEL aSelector, NXRemoteMethod * methods) 
id NXResponsibIeDelegate(id aListener, SEL aSelector) 


Services Menu Functions 

Determine whether an item is included in Services menus: 

int NXSetServicesMenuItemEnabled(const char *item, BOOL flag) 

BOOL NXIsServicesMenuItemEnabIed(const char *item) 

Programatically invoke a service: 

BOOL NXPerformService(const char *item, Pasteboard *pboard) 

Force Services menu to update based on new services: 

void NXUpdateDynamicServices(void) 


Event Function 


Access event record in event queue: 

NXEvent * NXGetOrPeekEvent(DPSContext context, NXEvent *anEvent, int mask, 

double timeout, int threshold, int peek) 


Memory Allocation Functions 


Macros to allocate memory: 

type-name * NX_MALLOC(type-«a/ne *var, type-name, int num) 
type-name * NX_REALLOC(ty/?e-namc *var, type-name, int num) 

void NX_FREE(void * pointer ) 
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Allocate a variable-sized array: 


NXChunk * 
NXChunk * 
NXChunk * 
NXChunk * 
NXChunk * 
NXChunk * 
NXChunk * 
NXChunk * 


NXChunkMalloc(int growBy, int initUsed) 
NXChunkRealloc(NXChunk *pc) 

NXChunkGrow(NXChunk *pc, int newUsed) 
NXChunkCopy(NXChunk *pc, NXChunk *dpc ) 
NXChunkZoneMalloc(int growBy, int initUsed, NXZone *zone) 
NXChunkZoneRealloc(NXChunk *pc, NXZone *zone) 
NXChunkZoneGrow(NXChunk *pc, int newUsed, NXZone *zone) 
NXChunkZoneCopy(NXChunk *pc, NXChunk *dpc, NXZone *zone) 


Macros to allocate zone memory: 

type-name * NX_ZONEMALLOC(NXZone *zone, type-name *var, type-name, int num ) 
type-name * NX_ZONEREALLOC(NXZone *zone, type-name *var, type-name, int num ) 


Other Application Kit Functions 

Get user's home directory and name: 

const char * NXHomeDirectory(void) 

const char * NXUserName(void) 

Synchronize the application with the Window Server: 

void NXPing(void) 

Find dimensions of specified paper type: 

const NXSize * NXFindPaperSize(const char *paperName ) 

Play the system beep: 

void NXBeep(void) 

Set up timer events: 

NXTrackingTimer * NXBeginTimer(NXTrackingTimer * timer, double delay, double period) 
void NXEndTimer(NXTrackingTimer *timer) 
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Allow journaling during direct mouse tracking: 

void NXJournalMouse(void) 

Set or copy current graphics state object: 

void NXSetGState(int gstate ) 

void NXCopyCurrentGState(int gstate ) 

Report user's request to abort: 

BOOL NXUserAborted(void) 

void NXResetUserAbort(void) 


Return file-related pasteboard types: 

NXAtom NXCreateFiIeContentsPboardType(const char *fileType) 

NXAtom NXCreateFilenamePboardiype(const char * filename ) 

const char * NXGetFiIeType(const char *pboard,Type) 

const char ** NXGetFileTypes(const char *const *pboardTypes) 

Find unique files from a path: 

int NXCompIeteFiIename(char *path, int maxPathSize) 


Draw a distinctive outline around linked data: 

void NXFrameLinkRect(const NXRect *aRect, BOOL isDestination ) 

float NXLinkFrameThickness(void) 


Get the amount of memory used by the Window Server: 

int NXGetWindowServerMemory(DPSContext context, int *virtualMemory, 

int *windowBackingMemory, NXStream *windowDumpStream) 

Macro to write an error message: 

void NX_ASSERT(int exp, char *msg ) 

Macro for debugging Display PostScript: 

void NX_PSDEBUG(void) 
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Types and Constants 


Defined Types 


NXAcknowledge 

typedef struct _NXAcknowledge { 
msg_header_t header; 
msg_type_t sequenceType; 
int sequence; 
msg_type_t errorType; 
int error; 

} NXAcknowledge 


NXAppkitErrorTokens 

typedef enum _NXAppkitErrorTokens { 

NX_longLine = NX_APPKIT_ERROR_BASE, 
NX_nullSel, 

NX_wordTablesWrite, 

NX_wordTablesRead, 

NX_textBadRead, 

NX_textBadWrite, 

NX_powerOff, 

NX_pasteboardComm, 

NX_mallocError, 

NX_printingComm, 

NX_abortModal, 

NX_abortPrinting, 

NX_illegalSelector, 

NX_appkitVMError, 

NX_badRtfDirective, 

NXJbadRtfFontTable, 

NX_badRtfStyleSheet, 

NXjnewerTypedStream, 

NX_tiffError, 

NX_printPackageError, 

NX_badRtfColorTable, 

NX_journalAborted, 

NX_draggingError, 
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NX_colorUnknown, 

NX_coIorBadIO, 

NX_colorNotEditable, 

NXJbadBitmapParams, 

NX_windowServerComm, 

NX_unavailableFont, 

NX_PPDIncludeNotFound, 

NX_PPDParseError, 

NXPPDIncIudeStackOverflow, 

NX_PPDIncludeStackUnderflow, 

NX_rtfPropOverflow 

} NXAppkitErrorTokens; 

IMXBreak Array 

typedef struct _NXBreakArray { 

NXChunk chunk; 

NXLineDesc breaks[l]; 

} NXBreakArray; 

NXCharArray 

typedef struct _NXCharArray { 

NXChunk chunk; 
wchar text[l]; 

} NXCharArray; 

NXCharFilterFunc 

typedef unsigned short (*NXCharFilterFunc) 
(unsigned short charCode, 
int flags, 

unsigned short charSet); 
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NXCharMetrics 

typedef struct { 

short charCode; 

unsigned char numKernPairs; 

unsigned char reserved; 

float xWidth; 

int name; 

float bbox[4]; 

int kernPairlndex; 

} NXCharMetrics; 

NXChunk 

typedef struct _NXChunk { 
short growby; 
int allocated; 
int used; 

} NXChunk; 

NXColorSpace 

typedef enum _NXColorSpace { 

NX_CustomColorSpace = -1, 
NX_OneIsBlackColorSpace = 0, 
NX_OneIsWhiteColorSpace = 1, 
NX_RGBColorSpace = 2, 
NX.CMYKColorSpace = 5 

} NXColorSpace; 

NXCompositeChar 

typedef struct { 

int compCharlndex; 
int numParts; 
int firstPartlndex; 

} NXCompositeChar; 
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NXCompositeCharPart 

typedef struct { 

int partlndex; 
float dx; 
float dy; 

} NXCompositeCharPart; 


NXDataLinkDisposition 

typedef enum _NXDataLinkDisposition { 

NX_LinkInDestination = 1, 
NX_LinkInSource = 2, 
NX_LinkBroken = 3 
} NXDataLinkDisposition 


NXDataLinkNumber 

typedef int NXDataLinkNumber; 

NXDataLinkUpdateMode 

typedef enum _NXDataLinkUpdateMode { 
NX_UpdateContinuousIy = 1, 
NX_UpdateWhenSourceSaved = 2, 
NXJUpdateManually = 3, 
NX_UpdateNever = 4 
} NXDataLinkUpdateMode 


NXDragOperation 

typedef enum _NXDragOperation { 
NX_DragOperationNone = 0, 
NX_DragOperationCopy = 1, 
NX_DragOperationLink = 2, 
NX_DragOperationGeneric = 4, 
NX_DragOperationPrivate = 8, 
NX_DragOperationAlI = 15 
} NXDragOperation; 


2-140 Chapter 2: Application Kit 



NXEncodedLigature 

typedef struct { 

unsigned char firstChar; 
unsigned char secondChar; 
unsigned char ligatureChar; 
unsigned char reserved; 

} NXEncodedLigature; 

NXErrorReporter 

typedef void NXErrorReporter(NXHandler *errorState ); 

NXFacelnfo 

typedef struct _NXFaceInfo { 

NXFontMetrics *fontMetrics; 
int flags; 

struct _fontFlags { 

unsigned int usedlnDoc: 1 ; 
unsigned int usedlnPage: 1 ; 
unsigned int usedlnSheetil; 
unsigned int _PADDING:13; 

} fontFlags; 

struct _NXFaceInfo *nextFInfo; 

} NXFacelnfo; 

NXFontMetrics 

typedef struct _NXFontMetrics { 
char *formatVersion; 
char *name; 
char *fullName; 
char *familyName; 
char ^weight; 
float italicAngle; 
char isFixedPitch; 
char isScreenFont; 
short screenFontSize; 
float fontBBox[4]; 
float underlinePosition; 
float underlineThickness; 
char ^version; 
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char *notice; 
char *encodingScheme; 
float capHeight; 
float xHeight; 
float ascender; 
float descender; 
short hasYWidths; 
float ^widths; 

unsigned int widthsLength; 
char *strings; 

unsigned int stringsLength; 
char hasXYKerns; 
char reserved; 
short ^encoding; 
float *y Widths; 

NXCharMetrics *charMetrics; 
int numCharMetrics; 

NXLigature ^ligatures; 
int numLigatures; 

NXEncodedLigature *encLigatures; 
int numEncLigatures; 
union { 

NXKemPair *kernPairs; 

NXKemXPair *kernXPairs; 

} kerns; 

int numKernPairs; 

NXTrackKern *trackKerns; 
int numTrackKerns; 

NXCompositeChar *compositeChars; 
int numCompositeChars; 
NXCompositeCharPart *compositeCharParts; 
int numCompositeCharParts; 

} NXFontMetrics; 

NXFontTraitMask 

typedef unsigned int NXFontTraitMask; 
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NXFSM 

typedef struct _NXFSM { 

const struct _NXFSM *next; 
short delta; 
short token; 

} NXFSM; 

NXHeightChange 

typedef struct _NXHeightChange { 
NXLineDesc lineDesc; 
NXHeightlnfo heightlnfo; 

} NXHeightChange; 

NXHeightlnfo 

typedef struct _NXHeightInfo { 
NXCoord newHeight; 

NXCoord oldHeight; 
NXLineDesc lineDesc; 

} NXHeightlnfo; 

NXJournalHeader 

typedef struct { 

int version; 

unsigned int offsetToAppNames; 
unsigned int lastEventTime; 
unsigned int reserved 1; 
unsigned int reserved2; 

} NXJournalHeader 

NXKernPair 

typedef struct { 

int secondCharlndex; 
float dx; 
float dy; 

} NXKernPair; 



NXKernXPair 


typedef struct { 

int secondCharlndex; 
float dx; 

} NXKernXPair; 

NXLay 

typedef struct _NXLay { 
NXCoord x; 

NXCoord y; 
short offset; 
short chars; 
id font; 

void *paraStyle; 
NXRun *run; 
NXLayFlags lFlags; 

} NXLay; 

NXLayArray 

typedef struct _NXLayArray { 
NXChunk chunk; 
NXLay lays[l]; 

} NXLayArray; 


NXLayFlags 

typedef struct { 

unsigned int musiMove: 1; 
unsigned int isMoveChar: 1 ; 
unsigned int RESERVED: 14; 
} NXLayFlags; 
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NXLaylnfo 


typedef struct _NXLayInfo { 

NXRect rect; 

NXCoord descent; 

NXCoord width; 

NXCoord left; 

NXCoord right; 

NXCoord rightlndent; 

NXLayArray *lays; 

NXWidthArray ^widths; 
NXCharArray * chars; 

NXTextCache cache; 

NXRect *textCIipRect; 
struct _lFlags { 

unsigned int horizCanGrowil; 
unsigned int vertCanGrow.l; 
unsigned int erase: 1; 
unsigned int ping: 1 ; 
unsigned int endsParagraph: 1; 
unsigned int resetCache: 1; 
unsigned int RESERVED: 10; 

} lFlags; 

} NXLaylnfo; 

NXLigature 

typedef struct { 

int firstCharlndex; 
int secondCharlndex; 
int ligaturelndex; 

} NXLigature; 

NXLineDesc 

typedef short NXLineDesc; 

NXLinkEnumerationState 

typedef struct { 
void *a; 
void *b; 

} NXLinkEnumerationState 
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NXMeasurementUnit 

typedef struct _NXMeasurementUnit { 

NX JJnitlnch = 0, 

NX_UnitCentimeter = 1, 

NX_UnitPoint = 2, 

NX_UnitPica = 3 
} NXMeasurementUnit; 

NXMessage 

typedef struct _NXMessage { 
msg_header_t header; 
msg_type_t sequenceType; 
int sequence; 
msg_type_t actionType; 
char action[NX_MAXMESSAGE]; 

} NXMessage 

NXModalSession 

typedef struct _NXModalSession { 
id app; 
id window; 

struct _NXModalSession *prevSession; 
int oldRunningCount; 

BOOL oldDoesHide; 

BOOL freeMe; 
int winNum; 

NXHandler *errorData; 
int reserved!; 
int reserved2; 

} NXModalSession; 


NXParagraphProp 

typedef enum { 

NX JLEFTALIGN = NX.LEFTALIGNED, 
NX_RIGHTALIGN = NX_RIGHTALIGNED, 
NX_CENTERALIGN = NX_CENTERED, 
NX_JUSTALIGN = NX_JUSTIFIED, 
NX_FIRSTINDENT, 

NX_INDENT, 
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NX_ADDTAB, 

NX_REMOVETAB, 

NX_LEFTMARGIN, 

NX.RIGHTMARGIN 

} NXParagraphProp; 

NXParamValue 

typedef union { 
int ival; 
double dval; 
port_t pval; 
struct _bval { 
char *p; 
int len; 

} bval; 

} NXParamValuet 

NXRect 

typedef struct _NXRect { 

NXPoint origin; 

NXSize size; 

} NXRect 

NXRemoteMethod 

typedef struct _NXRemoteMethod { 
SEL key; 
char * types; 

} NXRemoteMethod 

NXResponse 

typedef struct _NXResponse { 
msg_header_t header; 
msg_type_t sequenceType; 
int sequence; 

} NXResponse 
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NXRTFDError 

typedef enum { 

NX_RTFDErrorNone 
NX_RTFDErrorSaveAborted, 
NX_RTFDErrorUnabIeToWriteFile, 
NX_RTFDErrorUnableToCloseFile, 
NX_RTFDErrorUnableToCreatePackage 
NX_RTFDErrorUnableToCreateBackup, 
NX_RTFDErrorUnableToDeIeteBackup, 
NX_RTFDErrorUnableToDeleteTemp, 
NX_RTFDErrorUnableToDeleteOriginal, 
NX_RTFDErrorFileDoesntExist, 
NX_RTFDErrorUnableToReadFiIe, 
NX_RTFDErrorInsufficientAccess, 
NX_RTFDErrorMalformedRTFD 
} NXRTFDError; 


NXRun 

typedef struct _NXRun { 
id font; 
int chars; 
void *paraStyle; 
float textGray; 
int textRGBColor; 
unsigned char superscript; 
unsigned char subscript; 
id info; 

NXRunFlags rFlags; 

) NXRun; 

NXRunArray 

typedef struct _NXRunArray { 
NXChunk chunk; 

NXRun runs[l]; 

} NXRunArray; 
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NXRunFlags 

typedef struct { 

unsigned int underline: 1 ; 
unsigned int dummy: 1; 
unsigned int subclassWantsRTF:l; 
unsigned int graphic: 1; 
unsigned int RESERVED: 12; 

} NXRunFlags; 

NXScreen 

typedef struct _NXScreen { 
int screenNumber; 

NXRect screenBounds; 
NXWindowDepth depth; 

} NXScreen; 

NXSelPt 

typedef struct _NXSelPt { 
int cp; 
int line; 

NXCoord x; 

NXCoord y; 
int cist; 

NXCoord ht; 

} NXSelPt; 

NXSpellCheckMode 

typedef enum { 

NX_CheckSpelling, 

NX_CheckSpellingToEnd, 

NX_CheckSpellingFromStart, 

NX_CheckSpellingInSelection, 

NX_CountWords, 

NX_CountWordsToEnd, 

NX_CountWordsInSelection 

} NXSpellCheckMode; 



NXStreamSeekMode 

typedef enum { 

NX_StreamStart, 
NX_StreamCurrent, 
NX_StreamEnd 
} NXStreamSeekMode; 


NXStringOrderTable 

typedef struct { 

unsigned char primary[256]; 
unsigned char secondary[256]; 
unsigned char primaryCI[256]; 
unsigned char secondaryCI[256]; 

} NXStringOrderTable; 

IMXTabStop 

typedef struct _NXTabStop { 
short kind; 

NXCoord x; 

} NXTabStop; 

NXTextBlock 

typedef struct _NXTextBlock { 

struct _NXTextBlock *next; 
struct _NXTextBlock *prior; 
struct _tbFlags { 

unsigned int malloced:l; 
unsigned int PAD: 15; 

} tbFlags; 
short chars; 
wchar *text; 

} NXTextBlock; 
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NXTextCache 


typedef struct _NXTextCache { 
int curPos; 

NXRun *curRun; 
int runFirstPos; 

NXTextBlock *curBlock; 
int blockFirstPos; 

} NXTextCache; 

NXTextFilterFunc 

typedef char *(*NXTextFiIterFunc) 

(id self, 

unsigned char *insertText, 
int *insertLength, 
int position ); 

NXTextFunc 

typedef int (* NXTextFunc) 

(id self 

NXLaylnfo Haylnfo ); 

NXTextStyle 

typedef struct _NXTextStyle { 

NXCoord indentlst; 

NXCoord indent2nd; 

NXCoord lineHt; 

NXCoord descentLine; 
short alignment; 
short numTabs; 

NXTabStop *tabs; 

} NXTextStyle; 

NXTopLevelErrorHandler 

typedef void NXTopLevelErrorHandIer(NXHandler *errorState); 
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NXTrackingTimer 

typedef struct _NXTrackingTimer { 
double delay; 
double period; 

DPSTimedEntry te; 

BOOL freeMe; 

BOOL firstTime; 

NXHandler *errorData; 
int reservedl; 
int reserved2; 

} NXTrackingTimer; 

NXTrackKern 

typedef struct { 
int degree; 
float minPointSize; 
float minKernAmount; 
float maxPointSize; 
float maxKemAmount; 

} NXTrackKern; 

NXWidthArray 

typedef struct _NXWidthArray { 

NXChunk chunk; 

NXCoord widths[l]; 

} NXWidthArray; 

NXWindowDepth 

typedef enum _NXWindowDepth { 

NX_DefaultDepth = 0, 
NX_TwoBitGrayDepth = 258, 
NX_EightBitGrayDepth = 264, 
NX_TwelveBitRGBDepth = 516, 
NX_TwentyFourBitRGBDepth = 520 
} NXWindowDepth; 

wchar 

typedef unsigned char wchar; 
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Symbolic Constants 


Application Status 

Kit-Defined Subytypes 

NX_WINEXPOSED 

NX_APPACT 

NX_APPDEACT 

NX.WINMOVED 

NX_SCREENCHANGED 

System-Defined Subtype 

NX.POWEROFF 


Error Base Constants 

NX_APPKIT_ERROR_BASE 

NX_APP_ERROR_BASE 

Bits per Character 
or Integer 

NBITSCHAR 

NBITSINT 


Boolean Constants 

TRUE 

FALSE 


Value 


0 

1 

2 

4 

8 


1 


Value 

3000 

10000000 


Value 

8 

(sizeof(int)*NBITSCHAR) 

Value 

1 

0 


Box Borders 

NX_NOBORDER 

NX_LINE 

nx_bezel 

NX_GROOVE 
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Box Title Positions 

NX_NOTITLE 

NX_ AB O VETOP 

NX_ATTOP 

NX_BELOWTOP 

NX_ABOVEBOTTOM 

NX_ATBOTTOM 

NX_BELOWBOTTOM 


Button and ButtonCell Highlight/Display Types 

NX_MOMENTATYPUSH 

NX.PUSHONPUSHOFF 

NX_TOGGLE 

NX_SWITCH 

NX.RADIOBUTTON 

NX_MOMENTARY CHAN GE 

NX_ONOFF 


Button and ButtonCell Icon Positions 

NX_TITLEONLY 

NX_ICONONLY 

NXJCONLEFT 

NXJCONRIGHT 

NXJCONBELOW 

NX_ICONABOVE 

NXJCONOVERLAPS 


Cell and ButtonCell Parameter Constants 

NX.CELLDISABLED 

NX_CELLSTATE 

NX_CELLEDITABLE 

NX_CELLHIGHLIGHTED 

NX_LIGHTBYCONTENTS 

NX_LIGHTBYGRAY 

NX_LIGHTBYBACKGROUND 

NX_ICONISKEYEQUIVALENT 

NX_OVERLAPPINGICON 

NXJCONHORIZONTAL 

NX_ICONLEFTORBOTTOM 

NX_CHANGECONTENTS 

NX_BUTTONINSET 
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Cell Data Entry Types 

NX_ANYTYPE 

NXJNTTYPE 

NX_POSINTTYPE 

NX.FLOATTYPE 

NX_POSFLOATTYPE 

NX_DOUBLETYPE 

NX_POSDOUBLETYPE 


Cell sendActionOn: Flag 

NX_PERIODICMASK 


Cell Types 

NX_NULLCELL 

NX_TEXTCELL 

NXJCONCELL 


Color Panel Modes 

NX_GRAYMODE 

NX_RGBMODE 

NX_CMYKMODE 

NX_HSBMODE 

NX_CU STOMPALETTEMODE 

NX_CUSTOMCOLORMODE 

NX_BEGINMODE 


Color Panel Mode Masks 

NX_GR AYMODEM AS K 
NX_RGBMODEM AS K 
NX_CMYKMODEMASK 
NX_HSBMODEMASK 
NX_CUSTOMPALETTEMODEMASK 
NX_LISTMODEMASK 
NX_WHEELMODEM AS K 
NX_ALLMODESMASK 
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Color Picker Insertion 


Order Constants 

Value 

NX_WHEEL_INSERTION 

0.50 

NX_SLIDERS_INSERTION 

0.51 

NX_CUSTOMPALETTE_INSERTION 

0.52 

NX_LIST_INSERTION 

0.53 


Drawing Activity States 

NX_DRAWING 

NX_PRINTING 

NX_COPYING 


Meaning 

Drawing to the screen 
Spooling to a printer 
Copying to a pasteboard 


Event Thresholds State Value 

nx_basethreshold 1 

NX_RUNMODALTHRESHOLD 5 

NX_MODALRESPTHRESHOLD 10 


Figure Space Constant 

NX_FIGSPACE 


Font Attribute Constants 

NX_FONTHEADER 

NX_FONTMETRICS 

NX_FONTWIDTHS 

NX_FONTCHARDATA 

NX_FONTKERNING 

NX_FONTCOMPOSITES 


Font Conversion 

Constants Value 

NX_NOFONTCHANGE 0 

NX_VIAPANEL 1 

NX_ADDTRAIT 2 

NX_SIZEUP 3 

NX_SIZEDOWN 4 

NX_HEAVIER 5 

NX_LIGHTER 6 

NX_REMOVETRAIT 7 
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Font Matrix Constants 


NXJDENTITYMATRIX 

NX_FLIPPEDMATRIX 


Font Trait Constants 

NXJTALIC 

NX_BOLD 

NX_UNBOLD 

NX.NONSTANDARDCHARSET 

NX_NARROW 

NX_EXPANDED 

NX_CONDENSED 

NX_SMALLCAPS 

NX_POSTER 

NX_COMPRES SED 


FontPanel View Tags 

NX_FPPREVIEWFIELD 

NX_FPSIZEFIELD 

NX_FPREVERTBUTTON 

NX_FPPREVIEWBUTTON 

NX_FPSETBUTTON 

NX_FPSIZETITLE 

NX_FPCURRENTFIELD 


Gray Shades 

NX_WHITE 

NX_LTGRAY 

NXJDKGRAY 

NX_BLACK 


Icon and Token Window 
Dimensions 

NXJCONWIDTH 

NXJCONHEIGHT 

NX_TOKENWIDTH 

NX_TOKENHEIGHT 


Value 

0x00000001 

0x00000002 

0x00000004 

0x00000008 

0x00000010 

0x00000020 

0x00000040 

0x00000080 

0x00000100 

0x00000200 


Value 

1.0 

2.0/3.0 
1.0/3.0 
0.0 


Value 

48.0 

48.0 

64.0 

64.0 



Image Representation Device Matching Constant 

NX_MATCHESDEVICE 


Journaling Flags 

NX_JOURNALFLAG 
NX_JOURNALFLAGM AS K 


Journaling Listener 
Name 

NX_JOURNALREQUEST 

Journaling Recording 
Device 

NX_CODEC 

NX_DSP 


Journaling Status 

NX_STOPPED 

NX_PLAYING 

NX_RECORDING 

NX_NONABORTABLEFLAG 

NX_NONABORTABLEMASK 


Journaling Subevents 

NX_WINDRAGGED 

NX_MOUSELOCATION 

NX_LASTJRNEVENT 

Journaling Window 
Encodings 

NXJCEYWINDOW 

NX_MAINWINDOW 

NX.MAINMENU 

NX_MOUSEDOWNWINDOW 

NX.APPICONWINDOW 

NX_UNKNOWNWINDOW 


Value 

31 

(1 « NX_JOURNALFLAG) 


Value 

"NXJoumalerRequest" 


Value 

0 

1 


Value 

0 

1 

2 

31 

(1 « NX_NONABORTABLEFLAG) 


Value 


0 

1 

2 


Value 

(-D 

(- 2 ) 

(- 3 ) 

(- 4 ) 

(- 5 ) 

(- 6 ) 
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Listener Maximum 

Message Size Value 


NX_MAXMESSAGE 

(2048-sizeof(msg_header_t)- 

sizeof(msg_type_t)-sizeof(int)- 

sizeof(msg_type_t)-8) 

Listener Maximum 

Parameters 

Value 

NX_MAXMSGPARAMS 

20 

Listener Position Types 

Value 

NX.TEXTPOSTYPE 

0 

NX.REGEXPRPOSTYPE 

1 

NX.LINENUMPOSTYPE 

2 

NX_CHARNUMPOSTYPE 

3 

NX_APPPOSTYPE 

4 

Listener Reserved 

Message Numbers 

Value 

NXJSELECTORPMSG 

35555 

NX_SELECTORFMSG 

35556 

NX_RESPONSEMSG 

35557 

NX_ACKNOWLEDGE 

35558 


Listener RPC Error Return Values 
Error Value 

NXJNCORRECTMESSAGE -20000 


Listener Timeout Default Value 

NX_SENDTIMEOUT 10000 

NX_RCVTIMEOUT 10000 


Mach Executable File 
Segment Names for 

Images Segment Name 


NX.EPSSEGMENT 

NX_TIFFSEGMENT 

NX_ICONSEGMENT 


“_EPS” 

“_TIFF” 

“_ICON” 


Types and Constants 2-159 



Matrix Selection Mode Constants 


NX.RADIOMODE 

NX_HIGHLIGHTMODE 

NX_LISTMODE 

NX_TRACKMODE 


Modal Session 


Return Constants 

Value 

NX_RUNSTOPPED 

(-1000) 

NX_RUNABORTED 

(-1001) 

NX_RUNCONTINUES 

(-1002) 


Obsolete Speaker Constants 

NX_ISFILE, 

NXJSDIRECTORY, 

NX_ISAPPLICATION, 

NXJSODMOUNT, 

NX_ISNETMOUNT, 

NX_ISSCSIMOUNT, 

NXJSFLOPPYMOUNT 


Open Panel Tag 
Constants 

NX.OPICONBUTTON 

NX_OPTITLEFIELD 

NX.OPCANCELBUTTON 

NX.OPOKBUTTON 

NX_OPFORM 


Value 

NX_SPICONBUTTON 
NX_SPTITLEFIELD 
NX_SPCANCELBUTTON 
NX_SPOKBUTTON 
NX SPFORM 


Page Layout Panel Button Tags 

NX_PLICONBUTTON 

NX_PLTITLEFIELD 

NX_PLPAPERSIZEBUTTON 

NX_PLLAY OUTBUTTON 

NX_PLUNITSBUTTON 

NX_PLWIDTHFORM 

NX_PLHEIGHTFORM 

NX_PLPORTLANDMATRIX 

NX_PLSCALEFIELD 

NX_PLCANCELBUTTON 

NX_PLOKBUTTON 
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Page Order Modes 


NX_DESCENDINGORDER 

NX_SPECIALORDER 

NX.ASCENDINGORDER 

NX_UNKNOWNORDER 


Page Orientation Constants 

NX_PORTRAIT 

NX_LANDSCAPE 


Pagination Modes 

NX_ AUTOPAGINATION 

NX_FITPAGINATION 

NX_CLIPPAGINATION 


Panel Button Tags Value 

NX_OKTAG 1 

NX_CANCELTAG 0 

Panel Return Constants Value 

NX_ALERTDEFAULT 1 

NX_ALERTALTERNATE 0 

NX.ALERTOTHER -1 

NX_ALERTERROR -2 


Printer Table Key Length 

NX.PRINTKEYMAXLEN 


Printer Table States 

NX_PRINTERTABLEOK 

NX_PRINTERTABLENOTFOUND 

NX_PRINTERTABLEERROR 
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Rectangle Sides 


NX_XMIN 

NX_YMIN 

NX_XMAX 

NX_YMAX 


Save Panel Tag 

Constants Value 


NX_SPICONBUTTON 

NX_SPTITLEFIELD 

NX_SPBROWSER 

NX_SPCANCELBUTTON 

NXJSPOKBUTTON 

NX_SPFORM 


150 

151 

152 

NX_C AN CELTAG 

NX.OKTAG 

155 


Scroller Arrow Positions Value 

NX_SCROLLARROWSMAXEND 0 

NXJSCROLLARROWSMINEND 1 

NX_SCROLLARROWSNONE 2 


Scroller Part 

Identification Constants Value 

NX_NOPART 0 

NX_DECPAGE 1 

NX_KNOB 2 

NX.INCPAGE 3 

NX_DECLINE 4 

NXJNCLINE 5 

NX_KNOBSLOT 6 

NX_JUMP 6 

Scroller Usable Parts Value 

NX_SCROLLERNOPARTS 0 

NX_SCROLLERONLYARROWS 1 

NX_SCROLLERALLPARTS 2 


Scroller Width and Height 

NX.SCROLLERWIDTH (18.0) 
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Text Alignment Modes 


NX_LEFTALIGNED 

NX_RIGHTALIGNED 

NX_CENTERED 

NX_JUSTIFIED 


Text Block Constant 

NX_TEXTPER 


Text Key Constants 

nx_backspace 

NX_CR 

NX_DELETE 

NX_BTAB 

NXJLLEGAL 

NX_RETURN 

NX_TAB 

nx_backtab 

NX_LEFT 

NX_RIGHT 

NX_UP 

NX_DOWN 


Text Tab Stop Constant 

NX.LEFTTAB 


TIFF Compression Schemes 

NX_TIFF_COMPRESSION_NONE 
NX_TIFF_COMPRES SION_CCITTFAX3 
NX_TIFF_COMPRES SION_CCITTFAX4 
NX_TIFF_COMPRES SION_LZW 
NX_TIFF_COMPRES SION_JPEG 
NX_TIFF_COMPRESSION_PACKBITS 
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View Autoresize Constants 

NX_NOTSIZABLE 

NX_MINXMARGINSIZABLE 

NX_WIDTHSIZABLE 

NX_MAXXMARGINSIZABLE 

NX.MINYMARGINSIZABLE 

NX_HEIGHTSIZABLE 

NX.MAXYMARGINSIZABLE 


Window Button Masks 

NX.CLOSEBUTTONMASK 

NX_MINIATURIZEBUTTONMASK 


Window Frame Description String Length 

NX_MAXFRAMESTRINGLENGTH 


Window Styles 

NX_PLAINSTYLE 

NX_TITLEDSTYLE 

NX_MENUST YLE 

NX_MINIWINDOWST YLE 

NX_MINIWORLDSTYLE 

NX_TOKENST YLE 

NX_RESIZEBARSTYLE 

NX_FIRSTWINSTYLE 

NX_LASTWINSTYLE 

NX_NUMWINSTYLES 


Window Tiers 


Value 


NX_NORMALLEVEL 0 

NX_FLOATINGLEVEL 3 

NX_DOCKLEVEL 5 

NX_SUBMENULEVEL 10 

NX_MAINMENULEVEL 20 
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Workspace Request Constants (File Operations) 

Value 

WSM_MOVE_OPERATION 

"move" 

WSM_COPY_OPERATION 

"copy" 

WSM_LINK_OPERATION 

"link" 

WSM_COMPRESS_OPERATION 

"compress" 

WSM_DECOMPRES S_OPER ATION 

"decompress 

WSM_ENCRYPT_OPERATION 

"encrypt" 

WSM_DECRYPT_OPERATION 

"decrypt" 

WSM_DESTROY_OPERATION 

"destroy" 

WSM_RECYCLE_OPERATION 

"recycle" 

WSM_DUPLIC ATE_OPERATION 

"duplicate" 


Global Variables 


Application Object 

id NXApp; 

Break Tables 

const NXFSM *const NXEnglishBreakTable 
const int NXEnglishBreakTableSize 
const NXFSM *const NXEnglishNoBreakTable 
const int NXEnglishNoBreakTableSize 
const NXFSM *const NXCBreakTable 
const int NXCBreakTableSize 

Character Category Tables 

const unsigned char *const NXEnglishCharCatTable 
const unsigned char *const NXCCharCatTable 

Click Tables 

const NXFSM *const NXEnglishCIickTable 
const int NXEnglishClickTableSize 
const NXFSM *const NXCCIickTable 
const int NXCClickTableSize 
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Domain Name 

const char *const NXSystemDomainName; 

File Information 

NXAtom NXPlainFileType; 

NXAtom NXDirectoryFileiype; 

NXAtom NXAppIicationFileType; 
NXAtom NXFilesystemFileiype; 

NXAtom NXShellCommandFileType; 

Filename Extension for DataLinks 

NXAtom NXDataLinkFilenameExtension; 

Null Object 

int NXNullObject; 

Pasteboard Names 

NXAtom NXGeneralPboard; 

NXAtom NXFontPboard; 

NXAtom NXRulerPboard; 

NXAtom NXFindPboard; 

NXAtom NXDragPboard; 

Pasteboard Types 

NXAtom NXAsciiPboardType; 

NXAtom NXPostScriptPboardType; 
NXAtom NXTIFFPboardType; 

NXAtom NXRTFPboardType; 

NXAtom NXFilenamePboardType; 

NXAtom NXTabularTextPboardType; 
NXAtom NXFontPboardType; 

NXAtom NXRulerPboardType; 

NXAtom NXFileContentsPboardType; 
NXAtom NXColorPboardType; 
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Pasteboard Types 

NXAtom NXDataLinkPboardType; 

Pasteboard Types 

NXAtom NXSelectionPboardType; 

Process 

int NXProcessID; 

Screen Dump Switch 

BOOL NXScreenDump 

Smart Cut and Paste Tables 

const unsigned char *const NXEnglishSmartLeftChars 
const unsigned char *const NXEnglishSmartRightChars 
const unsigned char *const NXCSmartLeftChars 
const unsigned char *const NXCSmartRightChars 

View Drawing Status 

short NXDrawingStatus; 

Workspace Name 

const char *NXWorkspaceName; 

const char *const NXWorkspaceReplyName; 

#define NX_WORKSPACEREQUEST NXWorkspaceName 
#define NX_WORKSPACEREPLY NXWorkspaceReplyName 
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Common Classes and Functions 


Classes 


HashTable 


Inherits From: Object 

Initializing and Freeing a HashTable 
-init 

- initKeyDesc: (const char *)aKeyDesc 

- initKeyDesc: (const char *)aKeyDesc 

valueDesc: (const char *)aValueDesc 

- initKeyDesc: (const char *)aKeyDesc 

valueDesc:(const char *)aValueDesc 
capacity:(unsigned mt)aCapacity 

- free 

- freeObjects 

- freeKeys:(void (*)(void *))keyFunc 

values:(void (*)(void *))valueFunc 

- empty 

Copying a HashTable 

- copyFromZone:(NXZone *) zone 


Initializes a new, default HashTable 
Initializes a new HashTable 
Initializes a new HashTable 

Initializes a new HashTable 

Deallocates the HashTable 
Deallocates the HashTable’s objects 
Conditionally frees the HashTable’s associations 

Empties the HashTable but retains its capacity 


Returns an empty copy of the HashTable 
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Manipulating Table Associations 


- (unsigned int)count 

- (BOOL)isKey: (const void *)aKey 

- (void *)valueForKey:(const void *)aKey 

- (void *)insertKey:(const void *)aKey 

value:(void *)aValue 

- (void *)removeKey:(const void *)aKey 

Iterating Over All Associations 

- (NXHashState)initState 

- (BOOL)nextState:(NXHashState *)aState 

key:(const void **)aKey 
value:(void **)aValue 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Returns the number of objects in the table 
Indicates whether aKey is in the table 
Returns the value mapped to aKey 
Adds or updates akey/avalue pair 

Removes akeylavalue pair 


Begins process of iteration through the HashTable 
Moves to the next entry in the HashTable 


Read the HashTable from the typed stream stream 
Writes the HashTable to the typed stream stream 


List 


Inherits From: Object 


Initializing a IMew List Object 
-init 

- initCount: (unsigned int )numSlots 

Copying and Freeing a List 

-copyFromZone:(NXZone *)zone 
-free 

Manipulating Objects by Index 

- insertOb]ect:anObject at:(unsigned int )index 


Initializes the new List object 

Initializes the new List to hold at least numSlots objects 


Returns a copy of the List allocated from zone 
Deallocates the List object 


Puts anObject in the List at index 
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- addObject:anObject 

- removeObjectAt:(unsigned int)index 

- removeLastObject 

- replaceObjectAt:(unsigned int )index 

with inewObject 

- objectAt:(unsigned mt)index 

- lastObject 

- (unsigned int)count 

Manipulating Objects by id 

- addObject lanObject 

- addObjectlfAbsentranOZyect 

- removeObject :anObject 

- replaceObject lanObject with '.newObject 

- (unsigned int)indexOf lanObject 

Comparing and Combining Lists 

- (BOOL)isEqual:anC%'ecf 

- appendList:(List *)otherList 

Emptying a List 

- empty 

- freeObjects 

Sending Messages to the Objects 

-makeObjectsPerform:(SEL)flSe/ecfor 
-makeObjectsPerform:(SEL)aSWector 
with lanObject 

Managing the Storage Capacity 

- (unsigned int)capacity 

- setAvaiIableCapacity:(unsigned int )numSlots 

Archiving 

- write:(NXTypedStream *)stream 

- read:(NXTypedStream *)stream 


Adds anObject at the end of the List 
Removes the object located at index 
Removes the object at the end of the List 

Puts newObject in place of the object at index 
Returns the object at index 
Returns the object at the end of the List 
Returns the number of objects in the List 


Adds anObject at the end of the List 
Adds anObject to the List, if it’s not already in the List 
Removes first occurrence of anObject from the List 
Puts newObject in the List in place of anObject 
Returns the index of anObject 


Returns whether the two Lists have the same contents 
Adds the objects in otherList to the receiving List 


Empties the List of its contents, but doesn’t free the objects 
Deallocates all the objects in the List 


Sends an aSelector message to each object in the List 
Sends aSelector message with an argument to each object 


Returns the number of objects the List can store 
Sets the capacity of the List to at least numSlots objects 


Writes the List to the typed stream stream 
Reads the List from the typed stream stream 
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NXBundle 


Inherits From: Object 

Initializing a New NXBundle object 

- initForDirectory:(const char *)fullPath Initializes a new object for the fullPath directory 

Getting and Freeing an NXBundle 

+ mainBundle Returns the NXBundle for the directory of the executable 

+ bundleForCIass:c/<m06/ec/ Returns the NXBundle that loaded classObject 

- free Frees the receiving NXBundle, if it can be freed 

Getting a Bundled Class 

- principalClass Returns the principal class loaded by the receiver 

- classNamed:(const char *)classname Returns the class object for the classname class 

Setting Which Resources To Use 

+ setSystemLanguages:(const char * const *)languageArray 

Informs the receiver of the user’s language preferences 

Finding a Resource 

- (BOOL)getPath:(char *)path Provides the full path to the filename resource 

forResource:(const char *)filename 
ofType: (const char *) extension 

+ (BOOL)getPath:(char *)path Provides the full path to the filename resource 

forResource:(const char *)filename 
ofType:(const char *) extension 
inDirectory: (const char *) directory 
withVersion: (int) version 

Getting the Bundle Directory 

- (const char *)directory , Returns the full pathname of the NXBundle’s directory 
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Setting the Version 


- setVersion:(int)ven7on Sets the version that resources must match 

- (int)version Returns the version that resources must match 


NXStringTable 


Inherits From: HashTable : Object 


Initializing and Freeing an NXStringTable 

- init Initializes a new NXStringTable 

- free Deallocates the NXStringTable 


Querying an NXStringTable 

- (const char *)valueForStringKey: (const char *)aString 

Returns the value that corresponds to aString 


Writing Elements 

- readFromFile:(const char *)fileName 

- writeToFile:(const char *)fileName 

- readFromStream:(NXStream *)stream 

- writeToStream:(NXStream *)stream 


Reads the keys and values from fileName 
Writes the keys and values to fileName 
Reads the keys and values from stream 
Writes the keys and values to stream 


Storage 


Inherits From: Object 

Initializing a New Storage Object 

- init Initializes the Storage object 
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- initCount: (unsigned int )count 

elementSize:(unsigned int )sizeInBytes 
description:(const char *) descriptor 

Copying and Freeing Storage Objects 

- copyFromZone:(NXZone *)zone 
-free 

Getting, Adding, and Removing Elements 

- addElement:(void *)anElement 

-insertEIement:(void *)anElement 
at: (unsigned int)index 

- removeElementAt:(unsigned int)index 

- removeLastElement 

- replaceElementAt: (unsigned int )index 

with:(void *)anElement 

- empty 

- (void *)elementAt:(unsigned mt)index 

Comparing Storage Objects 

- (BOOL)isEqual :anObject 

Managing the Storage Capacity and Type 

- (unsigned int)count 

- (const char *)description 

- setAvailableCapacity: (unsigned in t)numSlots 

- setNumSlots: (unsigned int )numSlots 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Initializes the new object to store at least count elements 


Returns a copy of the Storage object allocated from zone 
Deallocates the Storage object and its contents 


Adds anElement at the end of the Storage array 

Puts anElement in the Storage array at index 
Removes the element located at index 
Removes the last element 

Replaces the element at index with anElement 
Empties the Storage object but retains its capacity 
Returns a pointer to the element at index 


Returns whether two Storage objects are the same 


Returns the number of elements currently stored 
Returns the encoding for the type of elements stored 
Sets the capacity of the Storage array to at least numSlots 
Sets the number of elements stored to numSlots elements 


Reads the Storage object from the typed stream stream 
Writes the Storage object to the typed stream stream 
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Functions 


Character Classification Functions 


Classify NeXTSTEP-Encoded Values: 


int 

NXIsAlpha(unsigned int c) 

int 

NXIsUpper(unsigned int c) 

int 

NXIsLo\ver(unsigned int c) 

int 

NXIsDigit(unsigned int c) 

int 

NXIsXDigit(unsigned int c) 

int 

NXIsAlNum(unsigned int c) 

int 

NXIsSpace(unsigned int c) 

int 

NXIsPunct(unsigned int c) 

int 

NXIsPrint(unsigned int c) 

int 

NXIsGraph(unsigned int c) 

int 

NXIsCntrl(unsigned int c) 

int 

NXIsAscii(unsigned int c) 


Convert NeXTSTEP-Encoded Characters: 

unsigned char * NXToAscii(unsigned int c) 

int NXToLower(unsigned int c ) 

int NXToUpper(unsigned int c) 


Defaults System Functions 


Set or Read Default Parameters: 


int 

const char * 
const char * 
int 
int 

const char * 

void 

int 

int 

const char * 


NXRegisterDefaults(const char * owner, const NXDefaults Vector vector) 
NXGetDefaultValue(const char *owner, const char *name) 
NXReadDefault(const char *owner, const char *name) 
NXRemoveDefault(const char *owner, const char *name) 
NXSetDefault(const char * owner, const char *name, const char *value) 
NXUpdateDefault(const char *owner, const char * name ) 
NXUpdateDefaults(void) 

NXWriteDefault(const char *owner, const char *name, const char *value) 
NXWriteDefaults(const char * owner, NXDefaults Vector vector) 
NXSetDefauItsUser(const char *newUser) 
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Error-Handling Functions 


Macros to Raise an Exception: 

void NX_RAISE(int code, const void *datal, const void *data2 ) 

void NX_RERAISE(void) 

val NX_ VALRETURN (val) 

void NX_VOIDRETURN 


Set and Return an Exception Raiser: 

void NXDefaultExceptionRaiser(int code, const void *datal, const void *data2) 

void NXSetExceptionRaiser(NXExceptionRaiser * procedure ) 

NXExceptionRaiser * NXGetExceptionRaiser(void) 


Macros to Handle Uncaught Exceptions: 

void NXSetUncaughtExceptionHandIer(NXUncaughtExceptionHandler *proc) 

NXUncaughtExceptionHandler * NXGetUncaughtExceptionHandler(void) 


Manage the Error Data Buffer: 

void NXAlIocErrorData(int size, void **data) 

void NXResetErrorData(void) 


Stream Functions 


Manipulate a IVlemory Stream: 


NXStream * 

NXStream * 

int 

void 

void 


NXOpenMemory(const char * address, int size, int mode ) 
NXMapFile(const char *pathName, int mode ) 
NXSaveToFile(NXStream * stream, const char *name) 
NXCloseMemory(NXStream * stream, int option ) 
NXGetMemoryBuffer(NXStream * stream, char **streambuf, int Hen, 
int *maxLen ) 


Open a File Stream or a Mach Port Stream: 

NXStream * NXOpenFile(int fd, int mode) 

NXStream * NXOpenPort(port_t port, int mode ) 
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Close a Stream: 


void NXCIose(NXStream * stream) 


Read From or Write to a Stream: 

int NXRead(NXStream * stream , void *buf, int count ) 

int NXWrite(NXStream * stream, const void *buf, int count) 

Read or Write Formatted Data from or to a Stream: 

int NXPutc(NXStream * stream, char c) /* a macro */ 

int NXGetc(NXStream * stream) /* a macro */ 

void NXUngetc(NXStream * stream) 

int NXScanf(NXStream * stream, const char * format, ...) 

void NXPrintf(NXStream * stream , const char * format , ...) 

int NXVScanf(NXStream * stream, const char * format , va_list argList) 

void NXVPrintf(NXStream * stream , const char * format, va_list argList) 

Register a Procedure for Formatting Data Written to a Stream: 

void NXRegisterPrintfProc(char/ormatC/zar, NXPrintfProc *proc, void *procData) 

Flush a Stream: 

int NXFlush(NXStream * stream ) 


Set or Report Current Position in a Stream: 

void NXSeek(NXStream * stream, long offset, int ptrName) 

long NXTell(NXStream * stream ) 

BOOL NXAtEOS(NXStream * stream) /* a macro */ 


Support a User-defined Stream: 


NXStream * 

NXStream * 

void 

int 

int 

int 

void 


NXStreamCreate(int mode, int createBuf) 

NXStreamCreateFromZone(int mode, int createBuf, NXZone *zone) 
NXStreamDestroy(NXStream * stream) 

NXDefaultRead(NXStream * stream, void *buf, int count) 
NXDefaultWrite(NXStream * stream, const void *buf, int count) 
NXFill(NXStream * stream) 

NXChangeBuffer(NXStream * stream ) 
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Typed Stream Functions 


Open or Close a Typed Stream: 

NXTypedStream* NXOpenTypedStream(NXStream * stream, int mode) 
void NXCloseTypedStream(NXTypedStream * stream ) 

NXTypedStream* NXOpenTypedStreamForFile(const char *fileName, int mode) 


Read or Write Objective C Objects from or to a Typed Stream: 

id NXReadObject(NXTypedStream * stream ) 

void NXWriteObject(NXTypedStream *stream, id object) 

void NXWriteObjectReference(NXTypedStream * stream, id object) 

void NXWriteRootObject(NXTypedStream * stream, id rootObject) 

Read or Write Arbitrary Data from or to a Typed Stream: 

void NXReadType(NXTypedStream * stream , const char *type, void *data) 

void NXWriteType(NXTypedStream * stream, const char *type, const void *data) 

void NXReadTypes(NXTypedStream * stream, const char *types ,...) 

void NXWriteTypes(NXTypedStream * stream, const char *types ,...) 

Read or Write Arrays from or to a Typed Stream: 

void NXReadArray(NXTypedStream * stream, const char *dataType, int count, 

void *data) 

void NXWriteArray(NXTypedStream * stream, const char *dataType, int count, 

const void *data) 


Read or Write an Object from or to a Typsd-Strsam Memory Buffs 5 " 


id NXReadObjectFromBuffer(const char * buffer, int length) 

char * NXWriteRootObjectToBuffer(id object, int * length) 

void NXFreeObjectBuffer(char *bujfer, int length) 


Determine Whether There's More Data to Be Read: 

BOOL NXEndOfTypedStream(NXTypedStream * stream ) 
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Flush a Typed Stream 


void NXFlushTypedStream(NXTypedStream * stream ) 

Get the Version Number of a Class 

int NXTypedStreamClassVersion(NXTypedStream * stream, const char *className ) 

Get or Set the Zone for a Typed Stream 

NXZone NXGetTypedStreamZone(NXTypedStream * stream ) 

void NXSetTypedStreamZone(NXTypedStream * stream, NXZone *zone ) 

id NXReadObjectFromBufferWithZone(const char * buffer, int length, 

NXZone *zone) 


Memory Allocation Functions 


Zone Memory Allocation 


void * 
void * 
void * 
void 

NXZone * 
NXZone * 
NXZone * 

void 

void 

NXZone * 
void 
int 
void 


NXZoneMalloc(NXZone *zone, size_t size) 

NXZoneCalloc(NXZone *zone, size_t numElems, size_t numBytes ) 
NXZoneRealloc(NXZone *zone, void *ptr, size_t size) 

NXZoneFree(NXZone *zone, void *ptr) 

NXDefaultMaliocZone(void) 

NXCreateZone(size_t startSize, size_t granularity, int canFree ) 
NXCreateChildZone(NXZone *parentZone, size_t startSize, size_t granularity, 
int canFree) 

NXMergeZone(NXZone *zone) 

NXDestroyZone(NXZone *zone) 

NXZoneFromPtr(void *ptr) 

NXZonePtrInfo(void *ptr) 

NXMallocCheck(void) 

NXNameZone(NXZone *zonep, const char *name) 
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Hash and String Table Functions 


Create, Manipulate, and Free a Hash Table: 


NXHashTable * 

NXHashTable * 

void 

void 

void 

NXHashTable * 

BOOL 

unsigned 

unsigned 

int 

int 

void 

void 


NXCreateHashTable(NXHashTablePrototype prototype , unsigned capacity , 
const void *info) 

NXCreateHashTabIeFromZone(NXHashTablePrototype prototype, 
unsigned capacity, const void *info, NXZone *zone) 
NXFreeHashTable(NXHashTable *table) 
NXEmptyHashTabIe(NXHashTable * table) 
NXResetHashTable(NXHashTable * table) 
NXCopyHashTabIe(NXHashTable * table) 

NXCompareHashTabIes(NXHashTable * table 1, NXHashTable * table!) 
NXPtrHash(const void *info, const void *data) 

NXStrHash(const void *info, const void *data) 

NXPtrIsEqual(const void *info, const void *datal, const void *data2) 
NXStrIsEqual(const void *info, const void *datal, const void *data2) 
NXNoEffectFree(const void *info, void *data) 

NXReallyFree(const void *info, void *data) 


Manipulate the Elements of a Hash Table: 


void * 
void * 
int 

void * 
void * 
unsigned 
NXHashState 
int 


NXHashInsert(NXHashTable *table, const void *data) 
NXHashInsertIfAbsent(NXHashTable *table, const void *data) 
NXHashMember(NXHashTable *table, const void *data) 
NXHashGet(NXHashTable *table, const void *data) 
NXHashRemove(NXHashTable *table, const void *data) 
NXCountHashTable(NXHashTable * table) 
NXInitHashState(NXHashTable *table) 

NXNextHashState(NXHashTable *table, NXHashState *state, void **data) 
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String Functions 


Get Localized Versions of Strings: 


const char * 
const char * 

const char * 

const char * 


NXLocalizedString(const char *key, const char *value, comment ) 
NXLocalizedStringFromTable(const char *table, const char *key, 
const char *value, comment ) 

NXLocalizedStringFromTableInBundle(const char *table, NXBundle * bundle, 
const char *key, const char *value, comment) 
NXLoadLocalizedStringFromTableInBundle(const char *table, 

NXBundle * bundle, const char *key, const char *value) 


Create a Unique String: 


NXAtom 
NXAtom 
NXAtom 
char * 
char * 


NXUniqueString(const char * buffer ) 
NXUniqueStringWithLength(const char * buffer, int length) 
NXUniqueStringNoCopy(const char * buffer ) 
NXCopyStringBuffer(const char * buffer ) 

NXCopyStringBufferFromZone(const char * buffer, NXZone *zone) 


Miscellaneous Functions 


Get a Pointer to the Objects Stored in a List: 

id * NX_ADDRESS(List *aList) 

Search for and Read a File: 

int NXFiIePathSearch(const char *envVarName, const char *defaultPath, 

int leftToRight, const char *fileName, int ( *funcPtr)Q, 
void *funcArg) 
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Types and Constants 


Defined Types 


NXAtom 

typedef const char *NXAtom; 

NXExceptionRaiser 

typedef void NXExceptionRaiser(int code, 
const void *datal, 
const void *data2 ); 

NXHandler 

typedef struct _NXHandler { 
jmp_buf jumpState; 
struct _NXHandler *next; 
int code; 

const void *datal, *data2; 

} NXHandler; 

NXHashState 

typedef struct { 
int i; 
iwlj; 

} NXHashState; 

NXHashTable 

typedef struct { 

const NXHashTablePrototype ^prototype; 

unsigned count; 

unsigned nbBuckets; 

void * buckets; 

const void *info; 

} NXHashTable; 
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NXHashTabiePrototype 

typedef struct { 

unsigned (*hash)(const void *m/o, const void *data ); 
int (*isEqual)(const void *info, const void *datal, const void *data2 ); 
void (*free)(const void *info, void *data)’, 
int style; 

} NXHashTabiePrototype; 

NXUncaughtExceptionHandler 

typedef void NXUncaughtExceptionHandIer(int code, 
const void *datal , 
const void *data2); 

NXZone 

typedef struct _NXZone { 

void *(*realloc)(struct _NXZone *zonep, void *ptr, size_t size)’, 
void *(*malloc)(struct _NXZone *zonep, size_t size ); 
void (*free)(struct _NXZone *zonep, void *ptr); 
void (*destroy)(struct _NXZone *zonep)', 

} NXZone; 


Symbolic Constants 

List Constants 

NX_NOTJN_LIST 

NXStringTable Constants Value 

MAX_NXSTRINGTABLE_LENGTH 1024 

Zone Constants Value 

NX_NOZONE (NXZone *)0 


Types and Constants 
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Global Variables 


HashTable Prototypes 

const NXHashTablePrototype NXPtrPrototype; 
const NXHashTablePrototype NXStrPrototype; 
const NXHashTablePrototype NXPtrStructKeyPrototype; 
const NXHashTablePrototype NXStrStructKeyPrototype; 
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Database Kit 


Classes 


DBAssociation 


Inherits From: Object 

Initializing 

- iniiFetchGroup:aFetchGroup 

expressionumExpr 

destinationraDesf 

Linking Expression and View 

- destination 

- fetchGroup 

- expression 

- setDestination :newDestination 


Initializes; associates aFetchGroup with aDest 


The association’s user interface object 

The DBFetchGroup that owns the association 

The DBExpression that selects the properties displayed 

Sets the user association’s user interface object 


Methods to be Re-Defined in a Subclass of Association 

- contentsDidChange Notice to redisplay because the value changed 

- currentRecordDidDelete Notice to redisplay because a record was deleted 
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- endEditing Notification that editing the destination must end 

- getVa!ue:va/ne Gets an object containing the association’s data 

- (unsigned int)selectedRowAfter: (unsigned int )previousRow 

The index of the next selected row 

- selectionDidChange Notice that the user has changed the selection 

- setValue:va/we Sets the association’s data 

- validateEditing Notice to validate changes the user has made 

Methods to be Defined in the Destination of a Custom Association 

- associatiomassociation Gets an object containing the association’s data 

getYalue:(DB Value *)value 

- association '.association Sets the association’s data 

setValue:(DBValue *)value 

- associationContentsDidChangeiassoc/at/oft Notice to redisplay because the value changed 
-associationCurrentRecordDidDelete:<3wocmn‘on 

Notice to redisplay because a record was deleted 

- associationSelectionDidChangeia ssodaf/on Notice that the user has changed the selection 


DBBinder 

Inherits From: Object 

Conforms To: DBCursorPositioning 

Initializing 

- init 

- init¥orDatabase:aDBDatabase 

withProperties:(List *)propertyList 
andQualifier:(DBQualifier *)aDBQualifier 

-free 

Connecting to a Database 

- (DBDatabase *)database 

- setDatabase:(DBDatabase *)aDatabase 


Initializes a new DBBinder instance 

Initializes database, properties, qualifier; frees DBBinder 

Frees the space allocated to a DBBinder 


The DBBimder’s DBDatabase 
Sets the DBBimder’s DBDatabase 
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Managing Properties 


- (List *)getProperties:(List *)aList 

- (List *)setProperties:(List *)aList 

- uddProperty‘.anObject 

- removePropertyAt: (unsigned int)index 

Managing the Qualifier 

- (DBQualifier *)qualifier 

- setQualifier:(DBQualifier *)aQualijier 

Managing the Container 

- (id <DBContainers>)container 

- setContainer:(id <DBContainers>)an(9Z?/ecr 

- setFlushEnabled:(BOOL)/?ag 

- (BOOL)isFlushEnabled 

- setF reeObj ectsO nFIush: (B O OL )flag 

- (BOOL)areObjectsFreedOnFlush 


Gets and returns the DBBinder’s properties 
Sets and returns the DBBinder’s properties 
Adds an object to the list of properties 
Deletes one of the objects from the list of properties 


The DBBinder’s qualifier 
Sets the DBBinder’s qualifier 


The DBBinder’s container 

Sets the DBBinder’s container 

Sets whether flushing the DBBinder is permitted 

Reports whether flushing is enabled; default YES 

Sets whether the DBBinder is freed when flushed 

YES if container objects freed when DBBinder is flushed 


Managing the Record Prototype 

+ setDynamicRecordCIassName: (const char *)aName Assign a unique name to a class for unprototyped records 

+ setDynamicRecordSuperclassName:(const char *)aName 

Identify (existing) superclass for unprototyped records 

Makes anObject the prototype for the DBBinder’s records 
Create default prototype object for the DBBinder’s records 
YES if createRecordPrototype will work (no prototype) 
The DBBinder’s record prototype 
Makes variableName report the value of aProperty 


- setRecordPrototypeia/iOZyect 

- createRecordPrototype 

- (BOOL)ownsRecordPrototype 

- recordPrototype 

- associateRecordlvar: (const char *)variableName 

withProperty : (id <DBProperties>)aPrope>ly 

- associateRecordSelectors ;(SEL).vet 

:(SEL)ger 

withProperty:(id <DBPropetXies>)aProperty 

- (DBValue *)valueForProperty:(id <DBProperties >)aProperty 

The value of aProperty for the current record 


Sets the selectors for storing and retrieving aProperty 
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Ordering and Ignoring Records 

- addRetrieveOrder:(DBRetrieveOrder)an(9rder for:(id <DBProperties>)aPro/?erry 

Appends aProperty to the retrieve ordering criteria 

- removeRetrieveOrderFor:(id <DBProperties>)aProp<?r/y 

Removes aProperty from the list of ordering criteria 

- (DBRetrieveOrder)retrieveOrderFor:(id <DBProperties>)aProperry 

The direction in which aProperty is sorted on retrieve 

- (unsigned int)positionInOrderingsFor:(id <DBProperties>)aProperty 

The rank order of aProperty in the list of order criteria 

- (BOOL)ignoresDuplicateResuIts YES if duplicate records are ignored during select 

- setIgnoresDuplicateResuIts:(BOOL)//ag Sets whether duplicate records will be ignored in select 

Accessing the Database 

- fetch 

- select 

- selectWithoutFetching 

- insert 

- update 

- delete 

- (BOOL)evaIuateString:(const unsigned char *)aString 

Tells the adaptor to evaluate aString (without qualifier) 

- (BOOL)adaptorWillEvaIuateString:(const unsigned char *)aString 

YES if delegate permits evaluation of aString; default YES 


Starts an asynchronous fetch to the container 
Aborts an asynchronous fetch 

Sends binderDidFetch: if an asynchronous fetch 
completes within timeout seconds 


Sets maximum records per synchronous fetch 
Returns maximum records per fetch; default unlimited 
YES if the previous fetch stopped for the record limit 


Fetching in a Thread 

- fetchlnThread 

- cancelFetch 

- checkThreadedFetchCompletion:(double)mneozzz 

Limiting a Fetch 

- setMaximumRecordsPerFetch:(unsigned mt)limit 

- (unsigned int)maximumRecordsPerFetch 

- (BOOL)recordLimitReached 


Fetches record; puts in record objects (in the container) 

Selects records and fetches them 

Selects records in the database for fetching 

Inserts the DBBinder’s record objects into the database 

Updates the database for each record object 

Deletes record object from the database 
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Using the Shared Cursors for Several Binders 

- setSharesContext:(BOOL)/fag Set whether this binder uses the shared cursor 

- (BOOL)sharesContext YES if this binder uses the shared cursor 

Managing General Resources 

- reset 

- (BOOL)flush 

- (NXZone *)scratchZone 

Appointing a Delegate 

- delegate 

- setDelegate: anObject 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 

Methods Implemented by the Delegate 

- binderiaBinder didEvaluateString:(const unsigned char *)aString 

Notification that aString was evaluated by the adaptor 

- (BOOL)binder:aZhWer willEvaluateString: (const unsigned char *)aString 

Notification that aString will be sent the adaptor; YES lets 

evaluation proceed 

Notification that records were deleted from the database 
Notification that records were fetched from the database 
Notification that records were inserted in the database 
Notification that records were selected (but not fetched) 
Notification that database records were updated 
YES permits deleting binder’s records from the database 
YES permits records to be fetched from the database 
YES permits records to be in sorted in the database 
YES permits records to be selected in the database 
YES permits records to update the database 


- binderDidDelete:aZhWer 

- binderDidFetch:a/?mder 

- binderDidInsert:aihW<?r 

- binderDidSelect:aflm<ier 

- binderDidUpdate:aBiWer 

- (BOOL)binderWillDelete:afim<ier 

- (BOOL)binderWillFetch:a5iW<2r 

- (BOOL)binderWillInsert:aBmzfer 

- (BOOL)binderWillSelect:aBmder 

- (B OOL)binderWillUpdate \aBinder 


Creates an instance by reading from a typed stream 
Archives an instance by writing to a typed stream 


The object that receives notification messages 
Sets the object to receive notification messages 


Cancels any fetch, then flushes and frees objects 

If enabled, empties the container 

The zone the DBBinder is now using for allocations 
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DBDatabase 


Inherits From: Object 

Initializing the Class 

+ initialize Sent automatically; prepares class to respond to inquiries 

Reporting What's Available 

+ (const char **)adaptorNames List of the names of available adaptors 

+ (const char **)databaseNamesForAdaptor:(const char *)anAdaptorName 

List of database available through anAdaptorName 

Initializing an Instance 

- initFromFile:(const char *)aPath Initializes and loads information from a model file 

Describing the Model Source 

- (const char *)directory The directory from which the model was loaded 

- (const char *)name The model’s name in the class’s name table 

- (BOOL)setName:(const char *)aString Sets the model's name in the class's name table 

- (const char *)currentAdaptorName The name of the current database adaptor 

- (const char *)defaultAdaptorName The name of the model’s default adaptor 

- (const unsigned char *)defaultLoginString The model’s default login string 

- (const unsigned char *)currentLoginString The current login string 

- (const unsigned char *)loginStringForUser:(const char *)aUser 

The the model’s login string for user aUser 

Describing the Database Model 

- (id <DBEntities>)entityNamed:(const char *)aName 

Returns an object embodying entity aName 

- (List *)getEntities:(List *)aList Returns a list of the names of the model’s entities 

Revising the Data Dictionary 

- emptyDataDictionary Frees the current data dictionary 

- loadDefauItDataDictionary Replaces the data dictionary by querying the database 
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Connecting to the Database 

+ findDatabaseNamed: (const char *)aName Returns a DBDatabase instance, after loading model 

connect: (BOOL)flag aName and (and, if flag is YES, connecting to it) 

- (BOOL)connect Opens a connection to database using the default login 

- (BOOL)connectUsingString:(const unsigned char *)aString 

Opens database connection to database by sending aString 

- (BOOL)connectUsingAdaptor:(const char *)aClassname 

andString: (const unsigned char *)aString Opens database connection via anAdaptor and aString 

- (BOOL)disconnect Disconnects from the database 

- (BOOL)disconnectUsingString:(const unsigned char *)aString 

Disconnects from the database by sending it aString 

- (BOOL)isConnected YES if there is a valid connection to the database 

- (const unsigned char *)connectionName The name assigned to the current connection 

Managing Transactions 

- (BOOL)beginTransaction 

- (BOOL)rollbackTransaction 

- (BOOL)commitTransaction 

- (BOOL)isTransactionlnProgress 

- (BOOL)areTransactionsEnabled 

- (B OOL)enableTransactions: (BOOL)flag 

Using a Delegate 

- delegate 

- setDelegate:miC%'ecf 

Evaluating an Arbitrary String 

- (BOOL)evaluateString:uSrmig Returns YES if the adaptor evaluates the string 

Controlling the User Interface 

- (BOOL)arePanelsEnabled YES if UI panels can respond to problems 

- setPanelsEnabled:(BOOL)//ag Enable/disable response by UI panels 

Archiving 

- read:(NXTypedStream *)stream Creates an instance by reading from a typed stream 

- write:(NXTypedStream *)stream Archives an instance by writing to a typed stream 


The object that receives notification messages 
Sets the object that receives notification messages 


YES if a new transaction is successfully started 

YES if a the current transaction is successfully rolled back 

YES if a the current transaction is successfully committed 

YES is a transaction is in progress 

YES if transactions are enabled 

Enable/disable transaction; returns YES if successful 
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Methods Implemented in the Delegate 

- db: aD at abase 

log:(const char *)fint, ... 

- ( BOOL)db:aDatabase 

notificationFrom lanObject 
message: (const unsigned char*)wsg 
code:(int)n 

- (BOOL)db ’.aDatabase 

willEvaluateString:(const char *)aString 
usingBInder: (const char *)aBinder 

- dbDidRoIlbackTransaction:sc/zf/cr 

- dbDidCommitTransactioni^en^cr 

- dbWillCommitTransactiom.stw/c/- 

- dbWillRollbackTransaction^enfife/* 


DBEditableFormatter 

Inherits From: DBFormatter : Object 

Initializing 

-init 

-free 

Manipulating Font 

-font 

- setFontraFont 


Notification of log message sent by aDatabase 

Notification of a message received from aDatabase; 
Returns YES when the user acknowledges the notifiation. 

Notice that aString will be evaluated; YES lets it proceed 

Notification that database rolled back a transaction 
Notification that database committed a transaction 
Notification that database will commit a transaction 
Notification that database will roll back a transaction 


Initializes a new instance 

Frees the space an instance formerly used 


Returns the font used in the editable display 
Sets the font used in the editable display 
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Displaying and Editing 


- drawFieldAt:(unsigned int) row Displays one field of the data source’s current record 

:column taken from position row or column of the dynamic axis, 

inside:(NXRect *)frame using rowAttrs or colAttrs to identify static attributes, 

inViewraV/evv and flags useRowPos and useColumnPos to select which 

vvithAttributes:(id <DBTableVectors>) rowAttrs 

:(id <DBTab\eVectors>)columnAttrs 

usePositions : (B O OL) useRowPos 

:(BOOL)useColumnPos 

- (BOOL)editFieldAt:(unsigned int)row Displays and prepares to edit one field of the data source’s 

:(unsigned int ^column current record, taken from row or column of dynamic axis, 

inside: (NXRect *)frame using rowAttrs or colAttrs to identify static attributes, 

inWiew.aView and flags useRowPos and useColumnPos to select which; 

withAttributes:(id <DBTableVectors>) rowAttrs 

:(id <DBTableVectors>) columnAttrs returns YES if editing was permitted 

usePositions:(BOOL)wse/?owPay 
: (B OOL) use ColumnPos 
onEvent itheEvent 


Controlling Editing 

- abortEditing 

- (BOOL)endEditing 

Archiving 

- read:(NXTypedStream *)stream 

- write :(NXTypedStream *)stream 

- finishUnarchiving 

Methods Implemented by the Delegate 

See DBFormatterValidation protocol. 


Forces an end to editing and discards changes; returns self 

Ends editing when user clicks elsewhere Returns YES if 
that becomes first responder 


Creates an instance by reading from a typed stream 
Archives an instance by writing to a typed stream 
Automatically invoked final step in unarchiving 
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DBExpression 


Inherits From: Object 

Conforms To: DBExpression Values 

DBProperties 

Creating and Freeing a DBExpression 

- initForEntity:(id <DBEntities>)<3n£>zrify Initializes for anEntity, with description string shown 

fromDescription:(const unsigned char *)descriptionFormat, ... 

- initForEntity:(id <DBEntities>)a«£> 2 ?riy Initializes anEntity, from property aName, 

fromName: (const char *)aName to have data type aType 

usingType: (const char *)aType 

- copyFromZone:(NXZone *)zone Returns new copy of receiver, allocated from zone 

- free Frees the space that an instance formerly used 

Setting the Entity and Description 

- setEntity:(id <DBEntities>)an£nriry Sets anEntity, with the description string shown 

andDescription: (const unsigned char *)descriptionFormat, ... 

Archiving 

- read:(NXTypedStream *)stream 

- write: (NXTypedStream *)stream 


DBFetchGroup 

Inherits From: Object 

Initializing 

- mMEntity'.anEntity Initialize a new instance for links to anEntity 

- setName: (const char *)aName Invoked automatically; matches the name to the attribute it 

fetches 


Creates an instance by reading from a typed stream 
Archives an instance by writing to a typed stream 
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Reporting Current Context 

- (const char *)name 

- module 

- entity 

- recordList 

- (unsigned int)currentRecord 

- (unsigned int)recordCount 


Returns the name (set to match the attribute it fetches) 
The DBModule that owns the fetch group 
The DBEntity for which the fetch group fetches 
The DBRecordList in which fetched records are stored 
The index within the DBRecordList of the current record 
The number of records in the DBRecordList 


Controlling Current Selection 

- set Autoselect: (BOOL )flag If YES, fetch selects first row, delete selects next rowf 

- (BOOL)doesAutoSelect Returns flag set by - setAutoselect:; default YES 

- setCurrentRecord:(unsigned int)newlndex Sets a position within the DBRecordList 

- clearCurrentRecord Deselects current record 

- (unsigned int)selectedRovvAfter:(unsigned int )previousRow 

Index of first selected row after previousRow 

- redisplayEverything Displays all of DBFetchGroup’s DBAssociations 


Manipulating Contents 

- deleteCurrentSelection Deletes the selected records from the DBRecordList 

- (BOOL)insertNewRecordAt:(unsigned int)index Inserts a (default) record in the DBRecordList at index 

- fetchContentsOf:aSoM/re usingQualifieriaQualifier 

Replaces all records by reading aSource using aQualifier 


Dealing with Changes 

- (BOOL)hasUnsavedChanges 

- (BOOL)validateCurrentRecord 

- saveChanges 

- discardChanges 


YES if the DBRecordList has been changed but not saved 
YES unless delegates for editor or DDModule object 
Saves changes in this or subordinate fetch groups 
Discards changes in this and subordinate fetch groups 


Using Associations 

- addExpressiomnewExpression 

- take ValueFromAssociation: anAssociation 

- addAssociation '.newAssociation 

- removeAssociation ’.anAssociation 


Adds newExpression to the list of expressions to fetch 
Puts the displayed value into the DBRecordList 
Adds newAssociation to the list of associations 
Removes anAssociation from the list of associations 
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Using a Delegate 

- delegate 

- setDelega teianObject 

Methods Implemented by the Delegate 

- fetchGroup: fetchGroup 

didInsertRecordAt:(int)zW<?x 

- (BOOL)fetchGroup:fetchGroup 

willValidateRecordAt:(int)mJejc 

- fetchGroup '.fetchGroup 

willDeleteRecordAt:(int)mdejc 

- (DBFailureResponse)fetchGroup:/etc/zGrow/? 

wilIFailForReason:(DBFailureCode)cod<? 

- fetchGroupDidFetch:/e/c/zGrow/? 

- fetchGroupDidSave:/efc/zGraw/? 

- fetchGroupWilIChange:/etc/*Growp 

- fetchGroup WillFetchifetchGroup 

- (BOOL)fetchGroupWilISave:/e/c/zGrow/? 


The object that receives notification messages 
Sets the object to receive notification messages 


Notification of a new record in the DBRecordList 
Notification of pending validation; YES lets it proceed 

Notification of pending deletion; YES .lets it proceed 

Returns constant to indicate response to failure notice 

Notification of new contents in DBRecordList 
Notification that DBRecordList has been saved 
Notification that user made changes in the DBRecordList 
Notification that fetch will change the DBRecordList 
Notification of pending save; YES lets it proceed 


DBFormatter 

(abstract superclass) 

Inherits From: Object 

Controlling the Data Source 

- dataSource Returns the DBRecordList (or other source) 

- setDataSourceinewDataSource Makes newDataSource the place to get values for display 
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Getting the Value to be Formatted 

- getValueAt: (unsigned int) row Returns a DBValue from the DBRecordList, 

:column taking it from position row or column of the dynamic axis, 

inside: (NXRect *)frame using rowAttrs or colAttrs to identify static attributes, 

inView:a View and flags useRowPos and useColumnPos to select which 

\vithAttributes:(id <DBTableVectors>) rowAttrs 

:(id <DBTableVectors>)cc>/wmnAtfrs 

usePositions: (B OOL)ttseRowPos 

:(BOOL )useColumnPos 

Formatting a Field 

- drawFieldAt: (unsigned int) row Displays one field of the data source’s current record 

‘.column taken from position row or column of the dynamic axis, 

inside:(NXRect *)frame using rowAttrs or colAttrs to identify static attributes, 

inView:aV?ew and flags useRowPos and useColumnPos to select which 

withAttributes:(id <DBTableVectors>) rowAttrs 
:(id <DBTableVectors>)c<?/wmnAttrj 
usePositions : (B 0 OL) useRowPos 
:(BOOL)w5e ColumnPos 

Batching Format Requests 

- beginBatching:(id <DBTableVectors>) attrs 

- endBatching 

- resetBatching:(id <DBTableVectors>)am*s 

Appointing a Delegate 

- delegate 

- setDelegate:anC%'ecr 


The object that receives notification messages 
Sets the object to receive notification messages 


Notification that format attrs apply to all following items 
Marks the end of a block of items formatted the same way 
Begin batching if not already started 
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DBImageFormatter 


Inherits From: DBFormatter : Object 


Initializing 

-init 

-free 


Initializes a new instance 

Frees the space an instance formerly used 


Default 

- setDefaultlmageran/mage 

- defaultlmage 


Set image to be shown when the data has none 
The image displayed when the data has none 


Display 


- drawFieldAt: (unsigned int) row 
:column 

inside:(NXRect *)frame 
inView:aV7ew 


Displays one image from the data source’s current record 
taken from position row or column of the dynamic axis, 
using rowAttrs or colAttrs to identify static attributes, 
and flags useRowPos and useColumnPos to select which 


withAttributes:(id <DBTableVectors>) rowAttrs 
:(id <DBTab\eVectors>)columnAttrs 
usePositions: (B OOL) w seRowPos 
: (BOOL )useColumnPos 


Archiving 

- read:(NXTypedStream *)stream 

- write: (NXTypedS tream *) stream 


Creates an instance by reading from a typed stream 
Archives an instance by writing to a typed stream 
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DBImageView 


Inherits From: Control: View : Responder : Object 


Internals 

- initFrame:(const NXRect *)frameRect 

- drawSelf:(const NXRect *)rects 

:(int )rectCount 

Getting/Setting the Image 

- image 

- setlmagemevv/mage 

Getting/Setting the Border 

- setStyle:(int)/zevvSty/e 

- (int)style 

Editing 

- (BOOL)isEditable 

- setEditab!e:(BOOL)/tog 


Initializes the view in the frame coordinates 
Called by display to draw the image 


Returns the image being displayed 
Makes newlmage the image to display 


Sets the style of border for the image 
Returns a constant indicating the border style 


YES if the image can be deleted or replaced 
Allow/prohibit deleting or replacing the image 


DBModule 


Inherits From: Object 

Reporting the Context 

- database 

- entity 

- rootFetchGroup 

- associationForObject:anC%<?ct 


The DBModule’s DBDatabase 

The DBModule’s DBEntity 

The DBModule’s root DBFetchGroup 

The DBAssociation that handles UI object anObject 
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- editingAssociation 

- getFetchGroups:(List *)aList 

- fetchGroupNamed:(const char *)aName 

Initializing and Configuring 

- initDatabas eiaDatabase 

entity: anEntity 

- fetchContentsOfraSonrce 

usingQudMdtrxaQualifier 

- nddFctchGroup:aFetchGroup 

Responding to User Actions 

- fetchAllRecords render 

- sa\eChanges:sender 

- discardChanges:sen<ier 

- deleteRecord '.sender 

- appendNewRecordtsender 

- insertNewRecordrsender 

- nextRecordisera/er 

- p re vi ou s R eco rd: sen de r 

- takeValueFromrsender 

- textDidEnd :text Object 

endChar: (unsigned short) why End 

- (B OOL)textWillChange: textObject 

- (BOOL)textWillEnd:^OZ?/'ect 

Using a Delegate 

- delegate 

- setDelegate:anO£yect 

Methods Implemented by the Delegate 

- moduleDidSave:moJn/e 

- (BOOL)moduleWiIlLoseChanges:mofi?n/e 

- (BOOL)moduleWillSave:wo(ii</e 


The DBAssociation currently involved in editing 
Returns a list of all the DBModule’s DBFetchGroups 
Returns the DBFetchGroup for the property named aName 


Initializes a new DBModule with the given DBDatabase 
and DBEntity, 

Fetches records for the DBEntity or DB Value aSource, 
using aQualifier to select records 

Invoked to add aFetchGroup to the list of fetch groups 


Fetches all records for the DBModule’s root fetch group 

Saves in the database changes made to the fetched records 

Discard changes proposed for the fetched records 

Delete one of the fetched records 

Append a new (default) record to those fetched 

Insert a new (default) record at the current position 

Select the next of the fetched records 

Select the preceding of the fetched records 

UI object has a new value, so fetched record is revised 

User has finished editing a text field 

User has entered an editable field; YES lets editing proceed 

Notification that an editable field will relinquish first 
responder; YES lets the change proceed 


The object that receives notification messages 
Sets the object to receive notification messages 


Called when module has completed a save to the database 
Called when module is about to discard user’s changes 
Called when module is about to save to the database 
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DBQualifier 


Inherits From: Object 

Conforms To: DBExpressionValues 

Initializing and Freeing 

+ initialize Automatically invoked to initialize the class 

- initForEntity:(id <DBEntiti&s>)anEntity Initializes a new instance to select from anEntity 

- initForEntity:(id <DBEntities>)anEntity Initializes to select from anEntity by descriptionFormat 

fromDescription:(const unsigned char ^descriptionFormat, ... 

- copyFromZone:(NXZone*)z Returns a copy of the DBQualifier, allocating from z 

- free Frees space that a DBQualifier formerly used 

Modifying 

- addDescription:(const unsigned char *)descriptionFormat, ... 

Appends descriptionFormat to the qualifier descriptions 

- setEntity:(id <DBEntities>)an£nWy Sets both anEntity and qualifying descriptionFormat 

andDescription:(const unsigned char *)descriptionFormat, ... 

- (BOOL)setName:(const char *)aName Assigns the DBQualifier aName and returns YES 

- (BOOL)empty Deletes the qualifying descriptions and returns YES 

Querying 

- (const char *)name 

- (id <DBEntities>)entity 

- (BOOL)isEmpty 

Archiving 

- read:(NXTypedStream *) stream Creates an instance by reading from a typed stream 

- write :(NXTypedStream *)stream Archives an instance by writing to a typed stream 


Returns the name assigned to the DBQualifier 

Returns the DB Qualifier’s entity 

Returns YES if the qualifying descriptions are empty 
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DBRecordList 


Inherits From: DBRecordstream 

Conforms To: DBContainers 

DBCursorPositioning 


Initializing and Freeing 

- init 
-free 

- clear 


Initializes a new instance of DBRecordList 
Frees the space a DBRecordList formerly used 
Empties the record list and lists of properties 


Setting the Retrieval Mode 

- setRetrieveMode:(DBRecordListRetrieveMode)aMode 

Sets the DBRecordList’s retrieval strategy 

- (DBRecordListRetrieveMode)currentRetrieveMode 

Returns a constant identifying the retrieval strategy 


Fetching Data from the Database 

- fetchRecordForRecordKey:(DB Value *)aValue 

- fetchUsingQualifier:(DB Qualifier *)aQualifier 

- fetchUsingQualifier:(DBQualifier *)aQualifier 

empty '.empty First 

- (unsigned int)recordLimit 

- sctRccordLimit: (unsigned int)count 

Accessing Data in the DBRecordList 

- getValue:(DB Value *)aValue 

forProperty:aProperty 

- getValue:(DB Value *)aValue 

forProperty :aProperty 
at: (unsigned \nt)index 

- getRecordKeyValue:(DB Value *)aValue 

- getRecordKeyValue:(DB Value *)aValue 

at:(unsigned in tfindex 


Fetches records qualified by matching aValue 
Empties, then fetches records selected by aQualifier 

Fetches records selected by aQualifier; 
if empty First is YES, first empties the record list 

Returns the maximum number of records to fetch 
Sets the maximum number of records to fetch 


Puts the current record’s value for aProperty into aValue 
Puts value of aProperty for the record at index into aValue 

Puts the key value for the current record into aValue 
Puts the key value for the record at index into aValue 
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Modifying Data in the DBRecordList 


- setValue:(DBValue *)aValue 

forProperty '.aProperty 

- setValue:(DBValue *)aValue 

forVroperty.aProperty 
at: (unsigned int)index 

- insertRecordAt:(unsigned int)index 

- appendRecord 

- newRecord 

- (BOOL)isNewRecord 

- (BOOL)isNewRecord At: (unsigned int )index 

- deleteRecord 

- deleteRecord At: (unsigned int )index 

- (BOOL)isModified 

- (BOOL)isModifiedAt:(unsigned mi)index 

- (BOOL)isModifiedForProperty:«Pro/?erfy 

at:(unsigned int)index 

Using Record Indexes 

- (unsigned int)positionForRecordKey:(DB Value 

- moveRecordAt:(unsigned mt)sourceIndex 

to: (unsigned int )destinationIndex 

- swapRecordAt: (unsigned m\)anlndex 

withRecord At: (unsigned mt)anotherIndex 

Saving Data 

- (unsigned int)saveModifications 


Sets the current record’s value of aProperty to aValue 
Sets value of aProperty for record at index to aValue 

Inserts a (default) record ahead of the record at index 

Inserts a (default) record after the last one 

Inserts a (default) record to precede the current record 

YES if the current record is one that has been inserted 

YES if the record at index had been inserted 

Deletes the current record 

Deletes the record at index 

YES if the current record has been changed or inserted 
YES if the record at index has been changed or inserted 
YES if aProperty of the record at index has been changed 


*)aValue 

Returns the index of the record whose key is aValue 

Moves record at sourcelndex to precede the record now 
at destinationlndex 

Transposes the positions of the two records 


Saves to the database any changes since the fetch; returns 
code for success, partial success, or failure 
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DBRecordStream 


Inherits From: Object 


Initializing and Freeing 

- init 
-free 

Setting up a DBRecordStream 

- addRetrieveOrder:(DBRetrieveOrder)an0r<ier 

for:(id <DBProperties>)aPro/?er/y 

- (List *)setProperties:(List *)propertyList 

ofSource:aSource 

- (List *)getProperties:(List *)propertyList 

- (List *)setKeyProperties:(List *)propertyList 

- (List *)getKeyProperties:(List *)keyList 

Fetching Data 

- fetchUsingQualifier:(DBQualifier *)aQualifier 

- cancelFetch 

- (DBRecordRetrieveStatus)currentRetrieveStatus 


Initializes a new instance 

Frees space formerly used by a DBRecordStream 


Appends anOrder (up/down) to sort criteria for aProperty 

Sets/returns list of properties wanted from entity aSource 

Returns and puts into propertyList the stream’s properties 
Sets and returns propertyList as the stream’s key properties 
Returns/ puts into propertyList the stream’s key properties 


Starts fetching records that pass aQualifier 

Stops fetching and sends fetchDone to DBDatabase 

DB_Ready/NotReady, DB_FetchInProgress/Completed 


Accessing Data 

- getVaiue:(DB Value *)aValue iorProperty'.aProperty 

Puts current record’s aProperty' s value into aValue 

- getRecordKeyValue:(DBValue *)aValue Puts current record’s key value into aValue 

- setNext Makes next record available; nil if none left 


Modifying Data 

- setValue:(DB Value *)aValue forProperty :aPropert 

Sets the current record’s aProperty to aValue 

- newRecord Inserts new, empty record at the current record 

- deleteRecord Deletes the current record 

- (BOOL)isNewRecord YES if the current record is a new one 
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- (BOOL)isModified 

- (BOOL)isReadOnly 


YES if the current record is new or has been modified 
YES if the record stream cannot be modified 


Saving Modifications 

- (unsigned int)saveModifications Writes current record’s modifications to the database 

Resetting a DBRecordStream 

- clear Resets everything except the delegate 

Assigning Delegates 

- delegate 

- setDelegat e:anObject 

- binderDelegate 

- setBinderDelegate:anC%'ect 

Method Implemented by the Delegate 

- (BOOL)recordStream:sen<ier Invoked when changes can’t be saved; aCode tells why; 

willFailForReason:(DBFailureCode) aCode YES acknowledges failure; NO tries to proceed with those 

records that are not affected 

- (BOOL)recordStreamPrepareCurrentRecordForModification:a/tec 0 r<iS , tream 

Invoked when a record will be modififed or deleted; YES 
permits modification to proceed 


The object that receives notification messages 
Sets the object that will receive notification messages 
The object that receives notification messages for binders 
Sets the object to receive notification messages for binders 


DBTableVector 

Inherits From: Object 

Conforms To: DBTableVectors 

Creating the Object 

- initldentifier :anldentifer Initialize a DBTableVector for property anldentifier 

- free Free the space formerly allocated to a DBTableVector 
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DBTableView 


Inherits From: ScrollView : View : Responder : Object 

Initializing and Freeing 

- initFrame: (const NXRect *)newFrame 

-free 

Setting up the DBTableView 

- setDataSourceraSowrce 

- dataSource 

- setDe\egate:delegate 

- delegate 

Displaying 

- drawSelf: (const NXRect *) rects :(int) count 

Setting and Reporting Formatting 

- formatter At: (unsigned intjrow :(unsigned int )column 

Returns the DBFormatter for the field at row and column 

- (BOOL)dynamicRows YES if rows are dynamic 

- (BOOL)dynamicColumns YES if columns are dynamic 

- (BOOL)isRowHeadingVisible YES if row heading view is visible 

- (BOOL)isColumnHeadingVisible YES if column heading view is visible 

- setIntercell:(const NXSize *)aSize Sets space between neighboring rows and columns 

- getlntercell:(NXSize *)theSize Puts space between rows and columns into theSize 

- setGridVisible:(BOOL)/fag Makes grid lines between rows and columns visible or not 

- (BOOL)isGridVisible YES if grid lines are visible 

- acceptArrowKeys:(BOOL)//<3g Makes arrow keys acceptable for navigation 

- (BOOL)doesAcceptArrowKeys YES if arrow keys are accepted for navigation 

- allowVectorReordering:(BOOL)/?(3g Lets/prevents user drag static row/column to new position 

- (BOOL)doesAllowVectorReordering YES if user is permitted to reorder static row or column 

- aIlowVectorResizing:(BOOL)/7ttg Lets/prevents user drag the width of static row or column 

- (BOOL)doesAllowVectorResizing YES if user can drag row or column to change width 


Sets the object that will provide data for the display 
The object that provides data for the display 
Sets the object that will receive notification messages 
The object that receives notification messages 


Initializes an instance located within newFrame 
Frees space formerly used by a DBTableView 
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Notifying the DBTableView of Change 

- reloadData ’.sender Redraw because data may have changed 

- layoutChanged:s<?nder Redraw because row or column spacing changed 

- rowsChangedFrom:(unsigned int )startRow Redraw because data changed in a block of rows 

to:(unsigned \nt)endRow 

- columnsChangedFrom: (unsigned int )startColumn Redraw because data changed in a block of columns 

to: (unsigned int )endColumn 


Handling Rows and Columns 

- (unsigned int)columnCount Total number of columns 

- (unsigned int)rowCount Total number of rows 

- (id <DBTableVectors>)row At: (unsigned in t)aPosition 

Object specifying format of the static row at aPosition 

- (id <DBTableVectors>)columnAt: (unsigned int )aPosition 

Object specifying format of the static column at aPosition 

- addColumn '.identifier Adds an static column at aPosition 

at: (unsigned int )aPosition 

- addColumi v.identifier Adds a static column with title at aPosition 

withTitle: (const char *)title 

- addCohimniidentifier Adds a static column with title and formatter at aPosition 

withFormnttcriformatter 
andTitle:(const char *)title 
at: (unsigned int )aPosition 

- removeColumnAt: (unsigned int )columnPosition Deletes a static column 

- (BOOL)moveColumnFrom:(unsigned int )oldPos Changes a static column’s position 

to: (unsigned int )newPos 

- addRow '.identifier 

at: (unsigned mi)aPosition 

- addRow '.identifier 

withTitle:(const char *)title 

- addRow: identifier 

withFormatter '.formatter 
andTitle:(const char *)title 
at:(unsigned int )aPosition 

- removeRowAt: (unsigned mi)rowPosition Deletes a static row 

- (BOOL)moveRowFrom: (unsigned int )oldPos Changes a static row’s position 

to:(unsigned int )newPos 

- (unsigned int)indedOfColumnWithIdentifier:a«/dent(/ier 

Position in sequence of static column anldentifier 

- (unsigned intjindexOfRowWithldentifier '.anldentifier 

Position in sequence of static row anldentifier 


Adds an static row at aPosition 

Adds a static row with title at aPosition 

Adds a static row with title and formatter at aPosition 
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Editing Support 


- editField At: (unsigned int)mw 

: (unsigned int )column 

- setEditable: (B OOL)flag 

- (BOOL)isEditable 


Selects an item and invokes editor 

Enables/disables editing. 

YES of the DBTableView is editable. 


Handling the Selection 

- setMode:(int)newMocfe 

- (int)mode 

- allowEmptySeI:(BOOL)/?ag 

- (BOOL)doesAllowEmptySel 

- (unsigned int)selectedRowCount 

- (unsigned int)selectedColumnCount 

- (int)selectedRow 

- (int)selectedColumn 

- (BOOL)isRowSeIected:(unsigned int)row 

- (BOOL)isColumnSelected: (unsigned int ^column 

- deselectAlhsender 

- selectAll: sender 

- setRowSeleetionOn:(unsigned int )start 

: (unsigned int )end 
to:(BOOL)j Hag 

- setColumnSelectionOn: (unsigned int)start 

•.(unsigned int )end 
to:(BOOL )flag 

- se!ectRow:(unsigned int)row 

byExtcnsion: (B 0 Q\J)flcig 

- selectColumn: (unsigned int)column 

by Extension: (B OOL )flag 

- dese!ectRow:(unsigned int )row 

- deselectColumn: (unsigned int ^column 

- (unsigned int)selectedRowAfter:(unsigned int)a/tow 


Make selection list mode, radio mode, or none. 

Returns DB_NOSELECT/RADIOMODE/LISTMODE 

Allow/prohibit user to leave nothing selected 

YES if user may leave nothing selected 

Number of rows currently selected 

Number of columns currently selected 

The row number of the selected row 

The column number of the selected column 

YES if row is selected 

YES if column is selected 

Makes nothing selected. 

Makes all rows and columns selected. 

Sets block of rows to selected (YES) or deselected (NO) 


Sets block of columns to selected (YES) or deselected 

Selects row, or extends selection if flag is YES 

Selects row, or extends selection if flag is YES 

Deselects the indicated row 
Deselects the indicated column 

v 

Index of the first selected row after aRow 


- (unsigned int)selectedColumnAfter:(unsigned int)aColumn 

Index of the first selected column after aColumn 


- sendAction:(S EL)anAction 
toianObject 

forS electedRo ws: (BOOL)flag 


Sends anAction to anObject for each selected row; 
if YES, does it for each selected row 
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- sendAction:(SEL)tf/2Acr/on Sends anAction to anObject for each selected column; 

toianObject if YES, does it for each selected column 

forSelectedColumns:(BOOL]/Zag 


Setting DBTableView Components 

- rowHeading 

- setRowHeading xnewRowHeading 

- setRowHeadingVisible:(BOOL)/fag 

- columnHeading 

- setColumnHcadinginewColumnHeading 

- setColumnHeadingVisible: (BOOL)flag 

Adjusting the View 

- display 

- scrollCIipmC/Zp 

to:(const NXPoint *)newOrigin 

- (BOOL)isHorizScrollerVisible 

- setHorizScrollerVisible: (BOOL )flag 

- (BOOL)isVertScrollerVisible 
-setVertScrollerVisible:(BOOL)/7ag 
-tile 

- sizeTo: (NXCoord) width 

:(NXCoord)height 

- scrollRowToVisible:(unsigned int)rovv 

- scrollColumnTo Visible: (unsigned int )column 

- (BOOL)acceptsFirstResponder 

Transmitting Action 

- setAction:(SEL)fl.S'e/ector 

- (SEL)action 

- setDoubleAction:(SEL)a5e/ector 

- (SEL)doubleAction 

- setTargeUanObject 

- target 


Returns the row heading view 

Makes newRowHeading the row heading view 

Makes the row heading visible or not 

Returns the column heading view 

Makes newColumnHeading the column heading view 

Makes the column heading visible or not 


Displays the DBTableView 

Sets aClip’s origin to be newOrigin in the content view 

YES if the content view’s horizontal scroller is enabled 
Makes the content view’s horizontal scroller visible or not 
YES if the content view’s vertical scroller is visible 
Makes the content view’s vertical scroller visible 
Recalculate positions of the component views and redraw 
Adjust the overall size to width and height, and redraw 

Scroll the content so that row is visible in the scroll clip 
Scroll the content so that column is visible in the scroll clip 
YES if the DBTableView will handle keyboard events 


Makes aSelector the action in response to a click 
The action to be sent on a click 

Makes aSelector the action in response to a double click 
The action in response to a double click 
Makes anObject the target for an action message 
The target for an action message 
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Archiving 


- read:(NXTypedStream *)stream 

- write: (NXTypedStream *)stream 

- finishUnarchiving 


Creates an instance by reading from a typed stream 
Archives an instance by writing to a typed stream 
Automatically invoked final step in unarchiving 


DBTextFormatter 

Inherits From: DBFormatter : Object 

Initializing 

- init 

- free 

Manipulating Font 

-font 

- setFont:«Fo/ 2 / 

Batching Format Requests 

- beginBatching:(id <DBTableVectors>) attrs 

- resetBatching:(id <DBTableVectors>) attrs 

- endBatching 

Archiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Initializes a new DBTextFormatter instance 
Frees the space allocated to a DBTextFormatter. 


Returns the formatter’s font 
Makes aFont the formatter’s font 


The format attrs applies to all following records 
Begins batching if not already in effect 
Completes sequence of records in same format 


Creates an instance by reading from a typed stream 
Archives an instance by writing to a typed stream 
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DBValue 


Inherits From: Object 

Conforms To: DBExpressionValues 

Creating and Freeing 

+ initialize 

-init 

-free 

Setting Values 

- setDoubleValue:(double)aDow/?/e 

- setFloat Value: (float)aF/oat 

- setlntValue: (int)anlnt 

- setObjectValue:(id)artO£yecf 
-setObjectValueNoCopy:(id)anO&/ect 

- setStringValue:(const char *)aString 

- setStringValueNoCopy:(const char *)aString 

- setValueFrom:(DBValue *)aValue 

- setNull 

Reporting Values 

- (id <DBTypes>)valueType 

- (BOOL)isEqual:(DBValue *)anotherValue 

- (double)doubleValue 

- (float)float Value 

- (int)intValue 

- objectValue 

- (const char *)stringValue 

- (BOOL)isNull 

Archivingt 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 


Initialize the class (sent by a subclass) 

Initialize a DBValue instance 

Free space formerly used by a DBValue instance 


Sets the object’s value to aDouble 

Sets the object’s value to aFloat 

Sets the object’s value to anlnt 

Sets the object’s value to anObject 

Sets the object’s value so that it points to anObject 

Sets the object’s value to aString 

Sets the object’s value so that it points to aString 

Sets the object’s to have the same value as aValue 

Sets the object’s value to NULL 


Returns the type of value the object contains 

YEs if this object has same type and value as anotherValue 

Returns the object’s value as a double 

Returns the object’s value as a float 

Returns the object’s value as an int 

Returns the object’s value as an object 

Returns the object’s value as a string 

YES if the object’s value is NULL 


Creates an instance by reading from a typed stream 
Archives an instance by writing to a typed stream 
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Protocols 


DBContainers 


Adopted By: 


DBRecordList 


Mandatory Methods 

- addObject:anOZ?/ect 

forBinder:(DBBinder *)aBinder 

- (unsigned int)count 

- empty 

- freeObjects 

- objectAt:(unsigned)mdejt 

forBinder:(DBBinder *)aBinder 

- (unsigned int)prepareForBinder:(DBBinder *)aBinder 

Readies the container to move data; returns count 


Adds anObject to aBinder’s container 

The number of objects in the container 
Removes (but doesn’t free) objects in the container 
Frees space formerly allocated to objects in the container 
Returns the index’th object in aBinder’s container 


Optional Methods 

- binder:(DBBinder *)aBinder 

didAcceptObject :anObject 

- binder:(DBBinder *)aBinder 

didRejectObjec UanObject 


Notification when anObject successfully stored in aBinder 
Notification when anObject could not be stored in aBinder 


DBCursorPositioning 


Adopted By: DBBinder 

DBRecordList 


Setting the Position 

- setFirst 


Sets cursor to container’s first record; returns the record 
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- setLast 

- setNext 

- setPrevious 

- setTo:(long)wdex 

Querying the Position 

- (long)currentPosition 


DBCustomAssociation 

(informal protocol) 

Category Of: Object 

Access to the Associated Value 

- association:association 

setValue:(DB Value *)value 

- association:association 

getValue:(DBValue *)value;- 

Notifications to the Associated Display 

- associationContentsDidChange : association 

- associationSelectionDidChange:cmoc/<3//on 
-associationCurrentRecordDidDelete:fl55oc/ar/o;z 


Sets cursor to container’s last record; returns the record 
Sets cursor to container’s next record; returns the record 

Sets cursor to container’s previous record; returns the 
record 

Sets cursor to index ; returns the index ’’th record 


Returns the current index (of objects in the container) 


Sets value into the associated data source 

Puts the value of the associated data source into value 


Notification that the data source has changed 
Notification of a change in selection in the display 

Notification that current record has been deleted from the 
data source 
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DBEntities 


Adopted By: none 

Incorporates: DBTypes 

Querying the Object 

- (const char *)name Returns the name of the entity 

- (DBDatabase *)database The DBDatabase object that created the entity 

- getProperties:(List *)aList Puts the entity’s properties into aList 

- propertyNamed: (const char *)aName Returns the DBProperty named aName 

Comparing the Object 

- (BOOL)matchesEntity:(id <DBEntities>)an£>zhYy YES if receiver is equivalent to anEntity 


DBExpressionValues 

Adopted By: DBExpression 

DBQualifier 
DB Value 

Methods 

- (const char *)expression Value Returns the receiver’s query-language expression 

- (BOOL)isDeferredExpression YES if evaluation of this expression can be deferred 
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DBFormatConversion 

(informal protocol) 


Category Of: Object 


- writeBuffer:(void*)&i{#er 

ofLength: (unsigned)/e/igr/i 
withFormat:(const char *)aFormatString 

If implemented, invoked automatically when custom object 
is written to the database 

DBFormatlnitialization 

(informal protocol) 


Category Of: Object 


- initFromBuffer:(void *)buffer 
ofLength:(unsigned)/engr/z 
withFormat:(const chai*)aFormatString 

If implemented, invoked automatically when custom object 
is written to the database 


DBFormatterValidation 

(informal protocol) 


Category Of: Object 


Notification Using the Changed Cell's Identifiers 

- formatterDidChangeValueFor:rc>w/dem(/ier Notification when a formatter has changed a value 
icolumnldentifer in one of the fields of a display; returns self 

sender '.sender 
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- (BOOLjformatterWillChangeValueFonrovv/den/i/zer 

icolumnldentifer Notification when a formatter will change a value 

sender '.sender 

- (BOOL)formatterWillChangeVaIueFor:/mvWen/(/h?r 

icolumnldentifer Notification when a formatter will change a value, 

to laValue with the proposed new value 

sender '.sender 


Notification Using the Changed Cell's Position 

- formatterDidChangeValueFor:/fifen///h?r 

at:(unsigned mt)position 
sender '.sender 

- (BOOL)formatterWiIIChangeValueFor:/fifent//z<?r 

at:(unsigned int )position 
sen&err.sender 

- (BOOL)formatterWillChangeVaIueFor:/Jen?//zer 

at:(unsigned int )position 
to laValue 
sender: sender 


Notification when a formatter has changed a value 
in one of the fields of a display; returns self 


Notification when a formatter will change a value 


Notification when a formatter will change a value, 
with the proposed new value 


DBFormatterViewEditing 


Category Of: Object 


Accepting changes 

- (BOOL)formatterEndedEditing ’.sender 
endChar:(unsigned short )whyEnd 


Invoked by editor when user ends editing; 
returns YES unless editing in progress 
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DBProperties 


Adopted By: DBExpression 

Identifying a Property 

- (const char*)name Name of the property 

- (BOOL)setName:(const char *)aName Set the name of a custom property; YES if successful 

- (id <DBEntities>)entity The entity to which the property belongs 

- (BOOL)matchesProperty:(id <DBProperties>)aPro/?erfy 

YES if receiver identifies same thing as aProperty 


Querying a Property 

- (id <DBTypes>) propertyType The type, as an object that responds to DBTypes protocol 

- (BOOL)isSingular YES if receive is an attribute or a one-to-one relationship 

- (BOOL)isReadOnly YES if the property’s data is read only 

- (BOOL)isKey YES if the property is a key property in the entity 

- (BOOL)matchesProperty:(id <DBProperties>)aPraper(y 

YES if receiver has same name in same entity as aProperty 


DBTableDataSources 

(informal protocol) 

Category Of: Object 

Reporting Table Size 

- (unsigned intjrowCount Number of rows in the data source table 

- (unsigned intjcolumnCount Number of columns in the data source table 
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Getting/Setting Data 


- getValueFor:rowIdentifier 

’.columnldentifier 

into ’.aValue 

- ge.t\a\\ieF or‘.identifier 

at: (unsigned int) aPosition 
into ‘.aValue 

- setValueF or‘.rowldentifier 

‘.columnldentifier 

irormaValue 

- setValueFor '.identifier 

at: (unsigned int) aPosition 
from:aValue 


Puts source value identified by properties rowldentifier and 
columnldentifier into aValue 

Puts value for property identifier at record aPosition 
into aValue 

Sets source value identified by properties rowldentifier and 

columnldentifier to aValue 

Sets value for property identifier at record aPosition 
to aValue 


DBTableValues 


(informal protocol) 


Category Of: Object 


Getting a Value from the Table 


- objectValue 

The item’s value as an object 

- (int)int Value 

The item’s value as an int 

- (double)double Value 

The item’s value as an double 

- (float)float Value 

The item’s value as an float 

- (const char *)stringValue 

The item’s value as an string 


Setting a Value in the Table 

- setObjectValue:(int)anO&y Sets the item’s value to anObj 

- setIntValue:(int)an/ftf Sets the item’s value to anlnt 

- setDouble Value :(double)aDon We Sets the item’s value to aDouble 

- setFloatValue:(float)aF/oat Sets the item’s value to aFloat 

- setStringValue: (const char *) aString Sets the item’s value to aStringt 
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DBTableVectors 


Category Of: Object 

Controlling/Reporting Formatter 

- formatter The formatter responsible for formatting the vector 

- setFormatter: newFormatter Makes newFormatter the vector’s formatter 

Controlling/Reporting Data Link 

- identifier 

- setldentifier :aDataAttribute 

Controlling/Reporting Editing 

- (BOOL)isEditable YES if the vector’s display is editable 

- setEditable:(BOOL)/7ag Permit/prohibit editing of the vector’s display 

Controlling/reporting Size 

- (BOOL)isResizable 

- setResizable:(BOOL)/fag 

- (BOOL)isAutosizable 

- setAutosizable:(BOOL)/7ag 

- (NXCoord)size 

- (NXCoord)sizeTo:(NXCoord)nevvS7zc 

- (NXCoord)minSize 

- setMinSize:(NXCoord) newMinSize 

- (NXCoord)maxSize 

- setMaxSize:(NXCoord) newMaxSize 

Controlling/Reporting Title 

- (const char *)title 

- setTitle:(const char *) title 

- titleFont 

- setTitIeFont:/onrC%' 
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The title (if row or column headings are shown) 
Makes title the vector’s title 
The font for displaying the title 
Makes fontObj the font for displaying the title 


YES if the vector’s display can be resized 

Permit/prohibit resizing the vector’s display 

YES if automatically resized when the view is resized 

Permit/prohibit automatic resizing 

Width and height of an item in the vector’s display 

Sets width and height of an item in the vector’s display 

The minimum limit on resizing 

Sets minimum limit on resizing 

The maximum limit on resizing 

Sets maximum limit on resizing 


The identifier for the property that the vector displays 
Makes aDataAttribute the vector’s identifier 



- (int)titleAlignment 

- setTitleAlignment:(int)a//gft 

Controlling/Reporting Content Alignment 

- (int)contentAIignment 

- setContentAlignment:(int) align 


A constant: NX_LEFT/CENTERED/RIGHTALIGNED 
Sets the title alignment to align 


A constant: NX_LEFT/CENTERED/RIGHTALIGNED 
Sets the content alignment to align 


DBTransactions 


Adopted By: DBBasicAdaptor : Object 


Begins a transaction; YES if successful 
Commits a transaction; YES if successful 
Rolls back a transaction; YES if successful 


Basic Transaction Commands 

- (BOOL)beginTransaction 

- (BOOL)commitTransaction 

- (BOOL)roIlbackTransaction 


DBTypes 


Adopted By: none 

Querying for Type 

- (const char *)objcType 

- (const char *)databaseType 

- (const char *)objcClassName 

Comparing Types 

- (BOOL)isEntity 

- (BOOL)matchesType:(id <DBTypes >)anObject 


"id" /"char *" /"int" /"float" /"double" as appropriate 

What the adaptor returns for the data’s type, for example 
"@" (for id) /"*" (for char *) /"i" /"f" /"d" 

Name of the stored data’s class (if any) 


YES if the object conforms to DBEntities protocol 
YES if anObject has the same data type as the receiver 
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Types and Constants 


Defined Types 


Access Exceptions 

typedef enum _DBAccessErrors { 

DB_UnimplementedException = DB_ERRORJBASE, 
DB_CoercionException, 

DB_FormatException, 

DB_CursorException, 

DB_CommitException 
} DBExceptions; 


Failure Codes 

typedef enum { 

DB_ReasonUnknown = 0, 
DB_RecordBusy, 
DB_RecordStreamNotReady, 
DB_RecordHasChanged, 
DB_RecordLimitReached, 
DB_NoRecordKey, 
DB_RecordKeyNotUnique, 
DB_NoAdaptor, 
DB_AdaptorError, 
DB_TransactionError 
} DBFailureCode; 


Failure Responses 

typedef enum { 

DB_NotHandled = 0, 
DB_Abort, 
DB_Continue 
} DBFailureResponse; 
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Image Style 


typedef enum { 

DB_ImageNoFrame = 0, 
DBImagePhoto, 
DBImageGrayBezel, 
DB_ImageGroove 
} DBImageStyle; 

Order of Retrieved Records 

typedef enum { 

DB_NoOrder = 0 
DB_AscendingOrder, 
DB_DescendingOrder 
} DBRetrieveOrder; 


Retrieval Mode of a Record List 

typedef enum _DBRecordListMode { 
DB_SynchronousStrategy, 
DB_BackgroundStrategy, 
DB_BackgroundNoBlockingStrategy, 
} DBRecordListRetrieveMode; 

Selection Mode in a DBTableView 

typedef enum { 

DB_RADIOMODE = 0, 
DB_LISTMODE = 2, 
DB_NOSELECT = 5 
} DBSelectionMode 

Status of Record Retrieval 

typedef enum _DBRecordRetrievalStatus { 
DB_NotReady, 

DB_Ready, 

DB_FetchLimitReached, 
DB_FetchInProgress, 
DB_FetchCompleted 
} DBRecordRetrieveStatus; 
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Symbolic Constants 


Error Numbers' Base Value 

DB_ERROR_BASE 


Format Types 

DBFormat_EPS 

DBFormat_RTF 

DBFormat_TIFF 


No Index Indicator 

DB_NoIndex 


Null Values 

DB_NullDouble 

DB_NullFloat 

DB_NullInt 


Record Limit Default 

DB_DEFAULT_RECORD_LIMIT 


(6000) 


"EPS" 

"RTF" 

"TIFF’ 


Oxffffffff 


(NAN) 

(NAN) 

((int)0x7ffffffe) 


1000 
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Display PostScript 


PostScript Operators 

This section summarizes the PostScript® operators. The following notation is used: 

Notation Means 

(Display) Extensions that were made by Adobe Systems Incorporated and 

NeXTSTEP for the Display PostScript System. 

(NeXTSTEP) NeXTSTEP extensions to the Display PostScript System. 

* Use this operator only if you’re bypassing the Application Kit. 

Your use of this operator within an application based on the 
Application Kit will conflict with the Kit’s use. 

This summary is organized into groups of related operators. The format used is the same 
as in the PostScript Language Reference Manual. Also as in that manual, the operand and 
result names suggest their types. Names representing numbers sometimes suggest their 
purpose (such as angle or window)', in operators implemented by NeXTSTEP, these names 
represent integers except for the following, which are real: 

• Coordinates, usually named as (or ending in) x and y 

• Widths and heights, usually so named 

• Coverage, a measure of transparency in “alpha” operators 

• Time (named secs, and measured in seconds) 

Several operators can optionally take an encoded number string as an operand, as indicated 
by numstring in the listing below. Use encoded number strings only when drawing to the 
screen. An application can use the global variable NXDrawingStatus to determine whether 
it’s drawing to the screen. 
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Compositing and Transparency Operators (NeXTSTEP) 


src x src y width height srcgstate 

dest x desty op 

composite - 

composite rectangle in source graphics state 
with image in current window 

dest x desty width height op 

compositerect - 

composite rectangle of current color and 
coverage with image in current graphics state 

src x srCy width height srcgstate 

dest x desty delta 

dissolve - 

dissolve between area of window referred to 
by srcgstate and equal area of window 
referred to by current graphics state 

window 

currentwindowalpha state 

return information about how window’s alpha 
values are stored 

x y width height proc 0 [... proc n .j] 

string bool 

readimage - 

read image’s pixel values and pass to 
corresponding procedures 

x y width height matrix 

sizeimage pixelswide pixelshigh bits/sample matrix multiproc ncolors 

get various parameters required for 
readimage to read the image 

pixelswide pixelshigh bits/sample 
matrix procQ [... proc n ] multiproc 

ncolors alphaimage - 

Instance Drawing Operators (NeXTSTEP) 

render data and alpha information supplied 
by one or more procedures 

- 

newinstance - 

remove instance drawing from current 
window 

bool 

setinslance - 

turn instance-drawing mode on or off 

x y width height hideinstance - 

Mouse and Cursor Operators (NeXTSTEP) 

remove instance drawing from rectangle 

eventnum 

stilldown bool 

test whether left/only mouse button is still 
down from mouse-down eventnum 

eventnum 

rightstilldown bool 

test whether right mouse button is still down 
from mouse-down eventnum 

window 

currentmouse x y 

return mouse location in base coordinates * 

- 

buttondown bool 

test whether left/only mouse button is down 


5-2 


Chapter 5: Display PostScript 



dxdy 
xy nix my 


bool context 
context 

x y width height leftbool rightbool 
insidebool userdata trectnum gstate 

trectnum gstate 

Event Operators (NeXTSTEP) 

mask window 
window 

type x y time flags window 
subType miscO miscl context 

bool window 

bool 

bool context 
context 

context 


rightbuttondown bool 
setmouse - 
adjustcursor - 
setcursor - 


test whether right mouse button is down 

set mouse and cursor location 

adjust cursor location by (dx, dy) 

set cursor to image with upper left at 
(x, y) and hot spot at offset (mx, my) from 
(x, y). 


hidecursor - remove cursor from screen 

showcursor - restore cursor to screen 

obscurecursor - remove cursor from screen until mouse 

moves 

revealcursor - restore cursor if still obscured 

setwaitcursorenabled - enable or disable wait cursor 

currentwaitcursorenabled bool 

return whether wait cursor is enabled 


settrackingrect - 
cleartrackingrect - 


set tracking rectangle in window referred to 
by gstate 

clear tracking rectangle in gstate 


seteventmask - set window’s Server-level event mask * 

currenteventmask mask return window’s current Server-level event 

mask * 


posteventbycontext bool 
setsendexposed - 

setflushexposures - 

setwaitcursorenabled - 
currentwaitcursorenabled 

setactiveapp - 

currentactiveapp context 


post event to specified context 

set whether window-changed events are 
generated for exposed window areas * 

set whether window-exposed and 
screen-changed subevents are flushed * 

enable or disable wait cursor operation 

bool 

return status of wait cursor in context 

establish application having context as the 
active application* 

return context of active application * 
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Frame Buffer Operators (NeXTSTEP) 


- countframebuffers count return number of frame buffers in use 

fbnum currentframebuffertransfer redproc greenproc blueproc grayproc 

return current transfer function for fbnum 

index string framebuffer name slot unit romid x y width height maxdepth 

provide information on specific frame buffer 

redproc greenproc blueproc 

grayproc fbnum setframebuffertransfer - set the transfer function for fbnum 

Window Management Operators (NeXTSTEP) 

jc y width height type window window create window and return its number * 

window termwindow - remove window from screen list; cause 

eventual freeing * 

type window setwindowtype - set window's type to type 

window windowdevice - set device of current graphics state to window 

window windowdeviceround - set device to window and round coordinate 

system to integer pixels 

- currentwindow window return window number of current device 

- setexposurecolor - set exposure color for nonretained window of 

current graphics state 

- flushgraphics - flush drawing in buffered window to screen 

place otherwindow window orderwindow - order Above or Below otherwindow (0 for 

all) or Out of screen list * 

level window setwindowlevel - set window tier for window to level 

window currentwindowlevel level return window tier for window 

- frontwindow window return frontmost window * 

x y width height window placewindow - reposition and resize with intersecting pixels 

unchanged * 

x y window movewindow - move lower left to screen coordinates (x, y) * 

window currentwindowbounds x y width height 

return window’s location and size in screen 
coordinates 

x y place otherwindow findwindow x' y' window bool locate window under screen coordinates 

(x, y) and give base coordinates (or return 
false ) 
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bool window setautofill - 

diet window setwindowdict - 

window currentwindowdict diet 
context countscreenlist count 

context countwindowlist count 

array context screenlist subarray 

array context windowlist subarray 

context window setowner - 


set whether exposure color fills window’s 
exposed areas automatically 

set window’s dictionary * 

return window’s dictionary * 

return number of windows in screen list that 
belong to context 

return number of windows that belong to 
context 

return window numbers of all windows in 
screen list that belong to context 

return window numbers of all windows that 
belong to context 

set owning PostScript context of window to 
context 


window currentowner context return PostScript context that owns window 

window currentdeviceinfo min max bool 

return window’s sampling density and 
whether device is color 


depth setdefaultdepthlimit - set depth limit for new windows * 

- currentdefaultdepthlimit depth 

return depth limit for new windows * 

window currentwindowdepth depth return window’s depth * 
depth window setwindowdepthlimit - set window’s depth limit * 

window currentwindowdepthlimit depth 

return window’s depth limit * 

dumplevel window dumpwindow - report position and number of bytes of 

backing store for window * 

dumplevel context dumpwindows - report position and number of bytes of 

backing store for all windows owned by 
context * 


statusdict Operators (NeXTSTEP) 

- ostype int return category of operating system 

(l=standalone, 3=UNIX® variant) 

- osname string return name of operating system 
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Operand Stack Manipulation Operators 


any 

pop - 

discard top element 

anyj any 2 

exch any 2 anyj 

exchange top two elements 

any 

dup any any 

duplicate top element 

anyj ... any n n 

copy anyj ... any n anyj... 

any n 

duplicate top n elements 

any n ... anyg n 

ind ex any n ... any q any n 

duplicate arbitrary element 

a n-l — a o n J 

roll a (j-l) mod n ••• a 0 a n-l ■ 

••• a jmodn 

roll n elements up j times 

1 - anyj ... any n 

clear 1 - 

discard all elements 

1 - anyj ... any n 

count 1 - anyj ... any n n 

count elements on stack 

- 

mark mark 

push mark on stack 

mark objj ... obj n 

cleartomark - 

discard elements down through mark 

mark objj ... obj n 

counttomark mark objj . 

.. obj n n 


count elements down to mark 

Arithmetic and Math Operators 


numj num 2 

add 

sum 

num j plus num 2 

numj num 2 

div 

quotient 

num j divided by num 2 

intj int 2 

idiv 

quotient 

integer divide 

intj int 2 

mod 

remainder 

intj mod int 2 

numj num 2 

mul 

product 

numj times num 2 

numj num 2 

sub 

difference 

nunij minus num 2 

numj 

abs 

num 2 

absolute value of num j 

numj 

neg 

num 2 

negative of num j 

numj 

ceiling num 2 

ceiling of num j 

numj 

floor 

num 2 

floor of num j 

numj 

round num 2 

round num j to nearest integer 

num j 

truncate num 2 

remove fractional part of numj 

num 

sqrt 

real 

square root of num 

num den 

atan 

angle 

arctangent of num/den in degrees 

angle 

cos 

real 

cosine of angle (degrees) 
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angle sin real 
base exponent exp real 
num In real 
num log real 

- rand int 
int srand - 

- rrand int 


sine of angle (degrees) 
raise base to exponent power 
natural logarithm (base e) 
logarithm (base 10) 
generate pseudo-random integer 
set random number seed 
return random number seed 


Array Operators 

int array array 

- [ mark 
mark objg... obj n _j ] array 

array length int 
array index get any 
array index any put - 
array index count getinterval subarray 

arrayj index array 2 putinterval - 

array aload a 0 ... a n .j array 
any 0 ... any n .j array astore array 
arrayi array 2 copy subarray 2 

array proc forall - 

any 0 ... any n _j n packedarray packedarray 

- currentpacking bool 
bool setpacking - 

packedarray length int 
packedarray index get any 
packedarray index count getinterval subarray 


create array of length int 

start array construction 

end array construction 

number of elements in array 

get array element indexed by index 

put any into array at index 

subarray of array starting at index for count 
elements 

replace subarray of array ; starting at index by 
array 2 

push all elements of array on stack 

pop elements from stack into array 

copy elements of arrayj to initial subarray of 
array 2 

execute proc for each element of array 

create packed array consisting of specified n 
elements 

return array packing mode 

set current array packing mode for ‘{...}’ 
syntax (true = packedarray) 

number of elements in packedarray 

get packedarray element indexed by index 

subarray of packedarray starting at index for 
count elements 
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packedarray aload a 0 ... a n _j packedarray 
packedarrayj array 2 copy subarray 2 

packedarray proc forall - 


push all elements of packedarray on stack 

copy elements of packedarray j to initial 
subarray of array 2 

execute proc for each element of packedarray 


Dictionary Operators 

int diet diet 

diet length int 
diet maxlength int 
diet begin - 

- end - 
key value def - 

key load value 

key value store - 
diet key get any 
diet key value put - 

- cleardictstack - 

diet key known bool 

key where diet true 
or false 

dieti dict 2 copy dict 2 
diet proc forall - 

- errordict diet 

- systemdict diet 

- userdict diet 

- currentdict diet 

- countdictstack int 
array dictstack subarray 


create dictionary with capacity for int 
elements 

number of key-value pairs in diet 
capacity of diet 
push diet on diet stack 
pop diet stack 

associate key and value in current diet 

search diet stack for key and return associated 
value 

replace topmost definition of key 
get value associated with key in diet 
associate key with value in diet 
return dictionary stack to initial state 
test whether key is in diet 

find diet in which key is defined 
copy contents of diet/ to dict 2 
execute proc for each element of diet 
push errordict on operand stack 
push systemdict on operand stack 
push userdict on operand stack 
push current diet on operand stack 
count elements on diet stack 
copy diet stack into array 
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String Operators 


int string string create string of length int 

string length int number of elements in string 

string index get int get string element indexed by index 

string index int put - put int into string at index 

string index count getinterval substring substring of string starting at index for count 

elements 

stringj index string2 putinterval - replace substring of stringj starting at index 

by string 2 

string j string 2 copy substring 2 copy elements of string j to initial substring of 

string 2 

string proc forall - execute proc for each element of string 

string seek anchorsearch post match true 

or string false determine if seek is initial substring of string 

string seek search post match pre true 

or string false search for seek in string 

string token post token true 

or false read token from start of string 

Relational, Boolean, and Bitwise Operators 

anyi any 2 eq bool 

anyi any 2 ne bool 

numfstrj num 2 \str 2 ge bool 

numj\strj num 2 \str 2 gt bool 

numj I strj num 2 1 str 2 le bool 

numfstrj num 2 \str 2 It bool 

boolfintj bool 2 \int 2 and bool f int3 

bool 1 1 int] not bool 2 \int 2 
boolj\int2 bool 2 \int 2 or bool 3 \int 3 
boolj\intj bool 2 \int 2 xor bool 3 \ int 3 

- true true 

- false false 
intj shift bitshift int 2 


test equal 

test not equal 

test greater or equal 

test greater than 

test less or equal 

test less than 

logical I bitwise and 

logical I bitwise not 

logical I bitwise inclusive or 

logical I bitwise exclusive or 

push boolean value true 

push boolean value false 

bitwise shift of inti (positive is left) 
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Rectangle Operators (Display) 



x y width height 
numarray 
numstring 

rectfill - 
rectfill - 
rectfill - 

fill path consisting of one or more rectangles 

x y width height 
x y width height matrix 
numarray 
numarray matrix 
numstring 
numstring matrix 

rectstroke - 
rectstroke - 
rectstroke - 
rectstroke - 
rectstroke - 
rectstroke - 

stroke path consisting of one or more 
rectangles 

x y width height 
numarray 1 numstring 

rectclip - 
rectclip - 

intersect inside of current clipping path with 
supplied path 

Control Operators 



any 

exec - 

execute arbitrary object 

bool proc 

if - 

execute proc if bool is true 

bool proc j proc 2 

ifelse - 

execute procj if bool is true, proc 2 if bool is 
false 

init incr limit proc 

for - 

execute proc with values from init by steps of 
incr to limit 

int proc 

repeat - 

execute proc int times 

proc 

loop 

execute proc an indefinite number of times 

- 

exit - 

exit innermost active loop 

- 

stop - 

terminate stopped context 

any 

stopped bool 

establish context for catching stop 

- 

countexecstack int 

count elements on exec stack 

array 

execstack subarray 

copy exec stack into array 

- 

quit - 

terminate interpreter 

- 

start - 

executed at interpreter startup 

Type, Attribute, and Conversion Operators 


any 

type name 

return name identifying any’ s type 

any 

cvlit any 

make object be literal 
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any 

any 

array I packedarray I file I string 

array\packedarray I dict\file I string 

array I packedarray I diet\file I string 

array I packedarray I diet I file I string 
array I packedarray I \file I s/rmg 

numstring 
string 
numstring 
num radix string 
any string 


cvx any 
xcheck bool 


make object be executable 
test executable attribute 


executeonly array I packedarray \file I string 

reduce access to execute-only 

noaccess array I packedarray \dict\file\ string 

disallow any access 

readonly array I packedarray I dict\file I string 

reduce access to read-only 


rcheck bool 
wcheck bool 
evi int 
cvn name 
cvr real 
cvrs substring 
evs substring 


test read access 

test write access 

convert to integer 

convert to name 

convert to real 

convert to string with radix 

convert to string 


open file identified by string 1 with access 
string 2 

remove specified file from device 

change file name from string j to string 2 

process each file whose name matches 
pattern with proc 

close file 


File Operators 

stringi string 2 

string 
string j string 2 
pattern proc scratch 

file 

file 

file int 
file string 
file string 
file string 
file string 
file string 


file file 

deletefile - 
renamefile - 
filenameforall - 

closefile - 

read int true 
or false 

write - 

readhexstring substring bool 
writehexstring - 
readstring substring bool 
writestring - 
readline substring bool 


read one character from file 
write one character to file 
read hex from file into string 
write string to file as hex 
read string from file 
write characters of string to file 
read line from file into string 
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file 

token token true 



or false 

read token from file 

file int 

setfileposition - 

position next read or write in file to int 

file 

fileposition int 

return current position in already open file 

file 

bytesavailable int 

number of bytes available to read 

- 

flush - 

send buffered data to standard output file 

file 

flushfile - 

send buffered data or read to EOF 

file 

resetfile - 

discard buffered characters 

file 

status bool 

return status of file 

string 

status pages bytes referenced created true 


or false 

(Display) return status of file 

string 

run - 

execute contents of named file 

- 

currentfile file 

return file currently being executed 

string 

print - 

write characters of string to standard output 
file 

any 

= — 

write text representation of any to standard 
output file 

1- anyj... any n 

stack 1- any j ... any n 

print stack nondestructively using = 

any 

== - 

write syntactic representation of any to 
standard output file 

1- anyj ... any n 

pstack 1- any j... any n 

print stack nondestructively using == 

- 

prompt - 

executed when ready for interactive input 

bool 

echo - 

turn on/off echoing 

Structured Output Operators (Display) 


int 

setobjectformat - 

set format for object sequences written by 

printobject and writeobject 

- 

currentobjectformat int 

return current object format used by 
printobject and writeobject 

obj tag 

printobject - 

write binary object sequence to standard 
output file 

file obj tag 

writeobject - 

write binary object sequence to file 
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Virtual Memory Operators (Display) 


save 
diet key 
bool 

any 

int 

Context Operators (Display) 

mark objj ... obj n proc 

context 

context 


lock proc 
lock condition 

condition 


Miscellaneous Operators 

proc 
index name 


save save 
restore - 
undef - 
setshared - 
currentshared bool 
scheck bool 
vmreclaim - 


create VM snapshot 
restore VM snapshot 

remove key and associated value from diet 
set private or shared VM allocation mode 
return current value of VM allocation mode 
return whether any is sharable 
control garbage collection mode 


vmstatus level used maximum report VM status 


fork context 

join mark objj ... obj n 


detach - 

currentcontext context 
lock lock 
condition condition 
monitor - 

wait - 

notify - 

yield - 


create new context within private VM of 
current context 

when context ceases execution, push its 
operand stack onto current context’s operand 
stack 

cause context to terminate when it’s done 
executing 

return integer identifying current context 
create lock 

create condition object 

acquire lock, execute proc , and then release 
lock 

release lock, wait for condition, and reacquire 
lock 

resume execution of contexts waiting for 
condition 

suspend current context until other contexts 
sharing same VM have executed 


bind proc replace operator names in proc by operators 

defineusername - (Display) associate index with name in user 

name table 
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bool 


soundname priority 


Graphics State Operators 


num 


int 


int 


num 


null null 

push null on operand stack 

usertime int 

(Display) return PostScript interpreter 
execution time 

realtime int 

(Display) return value of clock that counts in 
real time 

version string 

interpreter version 

nextrelease string 

(NeXTSTEP) NeXTSTEP version 
information 

setwriteblock - 

(NeXTSTEP) set whether Window Server 
blocks 

currentwriteblock bool 

(NeXTSTEP) return whether Server blocks 

currentuser uid gid 

(NeXTSTEP) return user id and group id of 
currently logged-in user 

currentrusage dime utime stime msgsend msgrcv nsignals nvcsw nivcsw 

(NeXTSTEP) report Window Server’s 
resource usage 

playsound - 

(NeXTSTEP) play soundname at given 
priority level 


gsave - 

save graphics state 

grestore - 

restore graphics state 

grestoreall - 

restore to bottommost graphics state 

initgraphics - 

(standard) reset graphics state parameters 
(NeXTSTEP) also reset alpha and instancing 

setlinewidth - 

set line width 

currentlinewidth num 

return current line width 

setlinecap - 

set shape of line ends for stroke (0=butt, 
l=round, 2=square) 

currentlinecap int 

return current line cap 

setlinejoin - 

set shape of corners for stroke (0=miter, 
l=round, 2=bevel) 

currentlinejoin int 

return current line join 

setmiterlimit - 

set miter length limit 

currentmiterlimit num 

return current miter limit 
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array offset 

mini 

patternname 

num 

hue sat brt 

red green blue 

coverage 

cyan magenta yellow black 

redproc greenproc 
blueproc grayproc 


proc 


proc 


setdash - set dash pattern for stroking 

currentdash array offset return current dash pattern 

setflat - set flatness tolerance 

currentflat num return current flatness 

setpattem - (NeXTSTEP) set pattern for drawing 

setgray - set color to gray value from 0 (black) to 1 

(white) 

currentgray num return current gray 

sethsbcolor - set color given hue, saturation, brightness 

currenthsbcolor hue sat brt return current color hue, saturation, 

brightness 

setrgbcolor - set color given red, green, blue 

currentrgbcolor red green blue 

return current color red, green, blue 

setalpha - (NeXTSTEP) set current coverage 

currentalpha coverage (NeXTSTEP) return current coverage setting 

setcmykcolor - set current color parameter in graphics state 

currentcmykcolor cyan magenta yellow black 

return current color parameter in graphics 
state 

setcolortransfer - set current transfer function parameters for 

specified colors 

currentcolortransfer redproc greenproc blueproc grayproc 

return current transfer function parameters 
for specified colors 

setblackgeneration - set current black generation function 

parameter in graphics state 

currentblackgeneration proc 

return current black generation function 
parameter in graphics state 

setundercolorremoval - set current undercolor removal function 

parameter in graphics state 

currentundercolorremoval proc 

return current undercolor removal function 
parameter in graphics state 
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redfrequency redangle redproc 
greenfrequency greenangle 
greenproc bluefrequency 
blueangle blueproc grayfrequency 

grayangle grayproc setcolorscreen - set all twelve current halftone screen 

parameters in graphics state 

- currentcolorscreen redfrequency redangle redproc greenfrequency 

greenangle greenproc bluefrequency blueangle 
blueproc grayfrequency grayangle grayproc 

return all twelve current halftone screen 
parameters in graphics state 

width height bits/sample matrix 

proc 0 [... proc n \ multiproc ncolors colorimage - render sampled image with 1, 3, or 4 color 

values 


freq angle proc setscreen - 

freq angle halftone setscreen - set halftone screen 

- currentscreen freq angle proc 

- currentscreen 60 0 halftone return current halftone screen or dictionary 

proc settransfer - set gray transfer function 

- currenttransfer proc return current transfer function 


Graphics State Object Operators (Display) 

- gstate gstate create graphics state object 

gstate setgstate - replace current graphics state by value of 

gstate 

gstate currentgstate gstate fill gstate with copy of current graphics state 


Halftone Definition Operators (Display) 

diet sethalftone - 

- currenthalftone diet 
x y sethalftonephase - 

- currenthalftonephase x y 


establish diet as current halftone dictionary 

return current halftone dictionary 

(Display) set current halftone phase 
parameters 

(Display) return current halftone phase 
parameters 
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Coordinate System and Matrix Operators 


xy 

basetocurrent x' y' 

(NeXTSTEP) convert from base to current 
coordinate system 

xy 

basetoscreen x' y' 

(NeXTSTEP) convert from base to screen 
coordinate system 

xy 

currenttobase x' y' 

(NeXTSTEP) convert from current to base 
coordinate system 

XJ 

currenttoscreen x' y' 

(NeXTSTEP) convert from current to screen 
coordinate system 

xy 

screentobase x' y' 

(NeXTSTEP) convert from screen to base 
coordinate system 

xy 

screentocurrent x' y' 

(NeXTSTEP) convert from screen to current 
coordinate system 

- 

matrix matrix 

create identity matrix 

- 

initmatrix - 

set CTM to device default 

matrix 

identmatrix matrix 

fill matrix with identity transform 

matrix 

defaultmatrix matrix 

fill matrix with device default matrix 

matrix 

currentmatrix matrix 

fill matrix with CTM 

matrix 

setmatrix - 

replace CTM by matrix 

*x ty 
t x t y matrix 

translate - 
translate matrix 

translate user space by (t x , t y ) 
define translation by (t x , t y ) 

s x s y 
s x s y matrix 

scale - 
scale matrix 

scale user space by s x and s y 
define scaling by s x and s y 

angle 
angle matrix 

rotate - 

rotate matrix 

rotate user space by angle degrees 
define rotation by angle degrees 

matrix 

concat - 

replace CTM by matrix X CTM 

matrixj matrix2 matrix3 

concatmatrix matrix3 

fill matrix3 with matrix1 X matrix 2 

xy 

x y matrix 

transform x' y' 
transform x' y' 

transform (x, y) by CTM 
transform (x, y) by matrix 

dx dy 
dx dy matrix 

dtransform dx' dy' 
dtransform dx' dy' 

transform distance (dx, dy) by CTM 
transform distance (dx, dy) by matrix 

x'y' 
x' y matrix 

itransform x y 
itransform x y 

inverse transform (x', y') by CTM 
inverse transform (x', /) by matrix 

dx' dy' 
dx' dy' matrix 

idtransform dx dy 
idtransform dx dy 

inverse transform distance (dx', dy') by CTM 
inverse transform distance (dx', dy') by matrix 

matrix 1 matrix 2 

invertmatrix matrix 2 

fill matrix 2 with inverse of matrix j 
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Path Construction Operators 

newpath - 

initialize current path to be empty 


- 

currentpoint x y 

return current point coordinate 


xy 

moveto - 

set current point to (x, y ) 


dx dy 

rmoveto - 

relative moveto 


xy 

lineto - 

append straight line to (x, y) 


dx dy 

rlineto - 

relative lineto 


xy r angj ang 2 

arc - 

append counterclockwise arc 


xy rang] ang 2 

arcn - 

append clockwise arc 


x l yi x 2 yi r 

arcto xt] yt] xt 2 yt 2 

append tangent arc 


x i yi x 2 y2 x 3 y 3 

curveto - 

append Bezier cubic section 


dx] dy] dx 2 dy 2 dx 2 dy 3 

rcurveto - 

relative curveto 


- 

closepath - 

connect subpath back to its starting point 


- 

flattenpath - 

convert curves to sequences of straight lines 


- 

reversepath - 

reverse direction of current path 


- 

strokepath - 

compute outline of stroked path 


string bool 

charpath - 

append character outline to current path 


- 

clippath - 

set current path to clipping path 


- 

pathbbox ll x ll y ur x ur y 

return bounding box of current path 


move line curve close 

pathforall - 

enumerate current path 


- 

initclip - 

set clipping path to device default 


- 

dip - 

establish new clipping path 


- 

eoclip - 

clip using even-odd inside rule 


User Path Operators (Display) 

ll x ll y ur x ur y 

setbbox - 

establish bounding box for current path 


x i yi x 2 y2 r 

arct - 

append arc of circle to current path 


userpath 

uappend - 

append userpath to current path 


bool 

upath userpath 

create userpath as copy of current path 
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userpath 

ufill - 

fill userpath as if by using fill operator 

userpath 

ueofill - 

fill userpath as if by using eofill operator 

userpath 

ustroke - 


userpath matrix 

ustroke - 

stroke userpath as if by using stroke operator 

userpath 

ustrokepath - 


userpath matrix 

ustrokepath - 

replace current path with userpath and stroke 
result 

- 

ucache - 

store enclosing user path if not already stored 

- 

ucachestatus mark bsize bmax rsize rmax blimit 

report status of user path cache 

mark blimit 

setucacheparams - 

set user path cache parameters 

View Clip Operators (Display) 

- 

viewclip - 

replace view clipping path with copy of 
current path 

- 

eoviewclip - 

replace view clipping path with current path 
using even-odd inside rule 

x y width height 

rectviewclip - 


numarray numstring 

rectviewclip - 

replace view clipping path with specified path 

- 

viewclippath - 

replace path with copy of current view 
clipping path 


initviewclip - 

replace view clipping path with one equal to 
imageable area 

Painting Operators 


erasepage - 

(NeXTSTEP) erase entire window to opaque 
white 

(standard) paint current page white 

- 

fill - 

fill current path with current color 

- 

eofill - 

fill using even-odd rule 

- 

stroke - 

draw line along current path 

width height bits/sample matrix proc 

image - 

render sampled image onto current page 

width height invert matrix proc 

imagemask - 

render mask onto current page 
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Window System Support Operators (Display) 



wtranslation x y 

return translation from window origin to 
device space origin 

userpath 

infill bool 
infill bool 

return true if pixel at (x, y) (or any pixels in 
userpath) would be painted by fill of current 
path 

xy 

userpath 

ineofill bool 
ineofill bool 

return true if pixel at (x, y ) (or any pixels in 
userpath) would be painted by eofill of 
current path 

x y userpath 
userpathj userpath 2 

inufill bool 
inufill bool 

return true if pixel at (x, y) (or any pixels in 
userpath ;) would be painted by ufill of 
current path 

x y userpath 
userpath j userpath 2 

inueofill bool 
inueofill bool 

return true if pixel at (x, y) (or any pixels in 
userpathj) would be painted by ueofill of 
current path 

xy 

userpath 

instroke bool 
instroke bool 

return true if pixel at (x, y) (or any pixels in 
userpath) would be painted by stroke of 
current path 

x y userpath 
x y userpath matrix 
userpath j userpath 2 
userpath j userpath 2 matrix 

inustroke bool 
inustroke bool 
inustroke bool 
inustroke bool 

return true if pixel at (x, y) (or any pixels in 
userpath;) would be painted by ustroke of 
current path 

- 

deviceinfo diet 

return diet containing static information 


about current device 


Device Setup and Output Operators 


proc window setshowpageprocedure - set the procedure that’s executed during 

showpage 

window currentshowpageprocedure proc 

return the procedure that’s executed during 
showpage 


- showpage 


output and reset current page 
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— 

copypage - 

output current page 

- 

nulldevice - 

install no-output device 

width height bbox matrix 

hostname portname pixelencoding 

machportdevice - 

(NeXTSTEP) set up PostScript device for 
generic rendering service 


Scan Conversion Operators (Display) 

bool setstrokeadjust - turn automatic stroke adjustment on or off 

- currentstrokeadjust bool return current state of automatic stroke 

adjustment 


Character and Font Operators 



key font 

definefont font 

register font as font dictionary 

key 

undefinefont - 

(Display) remove key from FontDirectory 
dictionary 

key 

findfont font 

return font diet identified by key 

font scale 

scalefont font' 

scale font by scale to produce new font' 

font matrix 

makefont font' 

transform font by matrix to produce new font 

font 

setfont - 

set font dictionary 

- 

currentfont font 

return current font dictionary 

string 

show - 

print characters of string on page 

a x a y string 

ashow - 

add ( a x , a y ) to width of each char while 
showing string 

text numarray\numstring 

xyshow - 

(Display) print characters according to x, y 
displacements in numarray or numstring 

text numarraylnumstring 

xshow - 

(Display) print characters according to x 
displacements in numarray or numstring 

text numarraylnumstring 

yshow - 

(Display) print characters according to y 
displacements in numarray or numstring 

c x c y char string 

widthshow - 

add (c x , cf) to width of char while showing 
string 

c x c y char a x a y string 

awidthshow - 

combine effects of ashow and widthshow 

proc string 

kshow - 

execute proc between characters shown from 
string 
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string stringwidth w x w y 

- FontDirectory diet 

- SharedFontDirectory diet 

- NextStepEncoding array 

- StandardEncoding array 
key scale\matrix selectfont - 


width of string in current font 

dictionary of font dictionaries 

(Display) dictionary of font dictionaries 

NeXTSTEP font encoding vector 

standard font encoding vector 

(Display) establish font specified by key as 
current font 


Font Cache Operators 


w x w y ll x lly ur x ur y 

w x w y 

num 

mark size lower upper 


cachestatus bsize bmax msize mmax csize cmax blimit 

return cache status and parameters 

setcachedevice - declare cached character metrics 

setcharwidth - declare uncached character metrics 

setcachelimit - set max bytes in cached character 

setcacheparams - set character cache parameters 

currentcacheparams mark lower upper 

return current font cache parameters 


User Object Encoding Operators (Display) 


Errors 


index any 

defineuserobject - 

associate index with an object in the user 
object array 

index 

undefineuserobject - 

remove associate between index and the 
object it referred to 

index 

execuserobject - 

execute object referred to by index 


dictfull 

no more room in dictionary 


dictstackoverflow 

too many begins 


dictstackunderflow 

too many ends 


execstackoverflow 

exec nesting too deep 


handleerror 

called to report error information 


interrupt 

external interrupt request (e.g., Control-C 
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invalidaccess 

attempt to violate access attribute 

invalidcontext 

invalid use of context synchronization 
facilities 

invalidexit 

exit not in loop 

invalidfileaccess 

unacceptable access string 

invalidfont 

invalid font name or diet 

invalidrestore 

improper restore 

invalidid 

(Display) invalid identifying number as 
operand 

ioerror 

input/output error occurred 

limitcheck 

implementation limit exceeded 

nocurrentpoint 

current point is undefined 

rangecheck 

operand out of bounds 

stackoverflow 

operand stack overflow 

stackunderflow 

operand stack underflow 

syntaxerror 

syntax error in PS program 

timeout 

time limit exceeded 

typecheck 

operand of wrong type 

undefined 

name not known 

undefinedfilename 

file not found 

undefinedresult 

over/underflow or meaningless result 

unmatchedmark 

expected mark not on stack 

unregistered 

internal error 

VMerror 

VM exhausted 
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Single-Operator Functions 


The single-operator functions listed here begin with the prefix “PS.” For every 
single-operator function with a “PS” prefix, there’s a corresponding single-operator 
function with a “DPS” prefix. The PS and DPS functions are identical except that DPS 
functions take an additional (first) argument that represents the PostScript execution 
context. To conserve space, only the single-operator functions prefixed with “PS” are listed 
here. (See “Suggested Reading” for references to documentation about Display 
PostScript.) 

Besides using the standard C types, these single-operator functions use boolean and 
userobject. A boolean variable is an int having either a zero or a nonzero value. The zero 
value is equivalent to the PostScript value false, and the nonzero value is equivalent to the 
PostScript value true. The userobject type is an int that refers to the value returned by 
DPSDefineUserObject(). 

void PSabs(void) 

void PSadd(void) 

void PSadjustcursor(float deltaX, float deltaYf 

void PSaload(void) 

void PSalphaimage(void)^ 

void PSanchorsearch(boolean *pflag) 

void PSand(void) 

void PSarc(float *, float y, float radius, float anglej, float angle 2 ) 

void PSarcn(float v, float y, float radius, float angle j, float angle 2 ) 
void PSarct(float xj, float yj, float x 2 , float y 2 , float radius) 

void PSarcto(float x, float y, float x 2 , float y 2 , float radius, float *pxt } , float *pyt], float *pxt 2 , 

float *pyt 2 ) 

void PSarray(int length ) 

void PSashow(float jc, float y, char * string) 
void PSastore(void) 

void PSatan(void) 

void PSawidthshow(float v, float y, int c, float ax, float ay, char * string ) 

void PSbasetocurrent(float jc, float y, float *px, float *pyf 

void PSbasetoscreen(float x, float y, float *px, float *py)^ 

void PSbegin(void) 

void PSbind(void) 
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void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 

void 


PSbitshift(int shift ) 

PSbuttondown(boolean *pflag 
PSbytesavailable(int *pcount) 

PScachestatus(int *pbsize, int *pbmax, int *pmsize ) 

PSceiling(void) 

PScharpath(char * string , boolean flag) 

PSclear(void) 

PScleardictstack(void) 

PScIeartomark(void) 

PScleartrackingrect(int tRectNum, userobject gstate) ' 

PSclip(void) 

PSclippath(void) 

PSclosefile(void) 

PSclosepath(void) 

PScoIorimage(void) 

PScomposite(lloat x, floaty, float width, float height, userobject srcGstate, float dest x , 
float dest y int op)^ 

PScompositerect(float dest x , float desty, float width, float height, int opY 
PSconcat(float m[6 ]) 

PSconcatmatrix(void) 

PScondition(void) 

PScopy(int n) 

PScopypage(void) 

Warning: This function has no effect in NeXTSTEP. 

PScos(void) 

PScount(int *pri) 

PScountdictstack(int *plength) 

PScountexecstack(int *pcount ) 

PScountframebuffers(int *pcountf 
PScountscreenlist(int context, int *pcounrf 
PScounttomark(int *pn) 

PScountwindowlist(int context, int *pcount j ] 

PScshow(char * string ) 
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void PScurrentactiveapp(int *pcontext ) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PScurrentalpha(float *pcoverage)^ 

void PScurrentblackgeneration(void) 

void PScurrentcacheparams(void) 

void PScurrentcmykcolor(float *pc, float *pm, float *py, float *pk) 

void PScurrentcolor(void) 

void PScurrentcolorrendering(void) 

void PScurrentcoIorscreen(void) 

void PScurrentcolorspace(void) 

void PScurrentcoIortransfer(void) 

void PScurrentcontext(int *pcontext) 

void PScurrentdash(void) 

void PScurrentdefaultdepthlimit(int *plimity 

Warning: Don’t use this function if you’re using the Application Kit. 

void PScurrentdeviceinfo(userobject window, int *pMinBPS, int *pMaxBPS, int *pColory 

void PScurrentdevparams(char * device ) 

void PScurrentdict(void) 

void PScurrenteventmask(userobject window, int *pmask ) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PScurrentfile(void) 

void PScurrentflat(float *pflatness) 

void PScurrentfont(void) 

void PScurrentframebuffertransfer(void) 

void PScurrentglobal(int *b) 

void PScurrentgray(float *pgray ) 

void PScurrentgstate(userobject gstate ) 

void PScurrenthalftone(void) 

void PScurrenthalftonephase(float *px, float *py) 

void PScurrenthsbcolor(float *ph, float *ps, float *pb) 

void PScurrentIinecap(int Spline cap) 

void PScurrentlinejoin(int *plinejoiri) 

void PScurrentlinewidth(float *pwidth) 

void PScurrentmatrix(void) 
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void PScurrentmiterlimit(float *plimit ) 

void PScurrentmouse(userobject window, float *px, float *py) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PScurrentobjectformat(int Opcode) 

void PScurrentoverprint(int *b) 

void PScurrentowner(userobject window, int *pcontex 

void PScurrentpacking(boolean *pflag ) 

void PScurrentpagedevice(void) 

void PScurrentpoint(float *px, float *py) 

void PScurrentrgbcolor(float *pr, float *pg, float *pb) 

void PScurrentrusage(float *pnow, float *puTime, float *psTime, int *pmsgSend, 

int *pmsgReceive, int *pnSignals, int *pnVCSw, int *pnIvCSw )’*’ 

void PScurrentscreen(void) 

void PScurrentshared(boolean *pflag) 

void PScurrentshowpageprocedure(void) 

void PScurrentstrokeadjust(boolean *pflag) 

void PScurrentsystemparams(void) 

void PScurrenttobase(float jc, float y, float *px, float *pyY 

void PScurrenttoscreen(float jc, float y, float *p: c, float *pyfl 

void PScurrenttransfer(void) 

void PScurrentundercolorremoval(void) 

void PScurrentuser(int *puid, int *pgidy 

void PScurrentuserparams(void) 

void PScurrentvvaitcursorenabled(boolean *pflag'y 

void PScurrentvvindow(int *pnumY 

void PScurrentwindowalpha(userobject window, int *palphay 

void PScurrentwindowbounds(userobject window, float *px, float *py, float *pwidth, 

float *pheighty 

Warning: Don’t use this function if you’re using the Application Kit. 

void PScurrentwindowdepth(userobject window, int *pdepthY 

Warning: Don’t use this function if you’re using the Application Kit. 

void PScurrentwindowdepthlimit(userobject window, int *plimit )' 

Warning: Don’t use this function if you’re using the Application Kit. 

void PScurrentwindowdict(userobject window ) 

Warning: Don’t use this function if you’re using the Application Kit. 
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void PScurrentwindowlevel(userobject window, int *pleveiy 
void PScurrentwriteblock(int *pflagY 

void PScurveto(float Xj, float yj, float float J2> fl° at x 3> fl° at X?) 

void PScvi(void) 

void PScvlit(void) 

void PScvn(void) 

void PScvr(void) 

void PScvrs(void) 

void PScvs(void) 

void PScvx(void) 

void PSdef(void) 

void PSdefaultmatrix(void) 

void PSdefinefont(void) 

void PSdefineresource(char * category ) 

void PSdefineusername(int index, char *name) 

void PSdefineuserobject(void) 

Warning: Use DPSDefineUserObject() instead. 

void PSdeletefiIe(char * 'filename ) 

void PSdetach(void) 

void PSdeviceinfo(void) 

void PSdict(int length) 

void PSdictstack(void) 

void PSdissolve(float src x , float src y float width, float height, userobject srcGstate, float dest x , 

float dcsty, float delta)'' 

void PSdiv(void) 

void PSdtransform(float jc, float y, float *px, float *py) 

void PSdumpwindow(int level, userobject window ) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSdumpwindows(int level, userobject context) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSdup(void) 

void PSecho(boolean flag) 

void PSend(void) 

void PSeoclip(void) 
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void PSeofill(void) 

void PSeoviewclip(void) 

void PSeq(void) 

void PSequals(void) 

void PSequalsequals(void) 

void PSerasepage(void) 

Warning: This function is different in NeXTSTEP. 

void PSerrordict(void) 

void PSexch(void) 

void PSexec(void) 

void PSexecform(void) 

void PSexecstack(void) 

void PSexecuteonly(void) 

void PSexecuserobject(int index) 

void PSexit(void) 

void PSexp(void) 

void PSfalse(void) 

void PSfile(char *name, char *access) 

void PSfilenameforall(void) 

void PSfileposition(int *ppos) 

void PSfill(void) 

void PSfilter(void) 

void PSfindencoding(char *key) 

void PSfindfont(char *name) 

void PSfindresource(char *key, char * category) 

void PSfindwindow(float jc, float y, int place, userobject otherWindow, float *px, float *py, 

int *pwinFound, boolean *pdidFind 

void PSflattenpath(void) 

void PSfloor(void) 

void PSflush(void) 

void PSflushfile(void) 

void PSflushgraphics(void)' 

Warning: Don’t use this function if you’re using the Application Kit. 
void PSFontDirectory(void) 
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void PSfor(void) 

void PSforall(void) 

void PSfork(void) 

void PSframebuffer(int index, int nameLength, char name[], int *pslot, int *punit, 

int *pROMid, int *px, int *py, int *pwidth, int *pheight, int *pdepth 

void PSfrontwindow(int *pnum ) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSgcheck(int *b) 

void PSge(void) 

void PSget(void) 

void PSgetboolean(boolean *pflag ) 

void PSgetchararray(int size, char string[]) 

void PSgetfloat(float Upvalue) 

void PSgetfloatarray(int size, float array[]) 

void PSgetint(int Upvalue) 

void PSgetintarray(int size, float array[]) 

void PSgetinterval(void) 

void PSgetstring(char * string ) 

void PSGIobalFontDirectory(void) 

void PSglobaldict(void) 

void PSglyphshow(char *name ) 

void PSgrestore(void) 

void PSgrestoreail(void) 

void PSgsave(void) 

void PSgstate(void) 

void PSgt(void) 

void PShidecursor(void)^ 

void PShideinstance(float x, float y, float width, float height)^ 
void PSidentmatrix(void) 

void PSidiv(void) 

void PSidtransform(float jc, float y, float *px, float *py) 

void PSif(void) 

void PSifelse(void) 
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void PSimage(void) 

void PSimagemask(void) 

void PSindex(int n ) 

void PSineofill(float x, float y, boolean *pflag ) 

void PSinfill(float x, float y, boolean *pflag ) 

void PSinitclip(void) 

void PSiniteventtimes(void) 

void PSinitgraphics(void) 

Warning: This function is different in NeXTSTEP. 

void PSinitmatrix(void) 

void PSinitviewclip(void) 

void PSinstroke(float x, float y, boolean *pflag ) 

void PSinueofill(float x, float y, char nums\n\, int n, char ops[l], int l, boolean *pflag) 

void PSinufill(float jc, float y, char nums[n ], int n, char ops[l], int l, boolean *pflag ) 

void PSinustroke(float x, float y , char nums[n], int n, char ops\l\, int /, boolean *pflag ) 

void PSinvertmatrix(void) 

void PSISOLatinlEncoding(void) 

void PSitransform(float jc, float y, float *px, float *py) 

void PSjoin(void) 

void PSknown(boolean *pflag ) 

void PSkshow(char * string ) 

void PSlanguagelevel(int */i) 

void PSle(void) 

void PSleftbracket(void) 

void PSleftleft(void) 

void PSlength(int *pn) 

void PSlineto(float x, float y) 

void PSln(void) 

void PSload(void) 

void PSlock(void) 

void PSlog(void) 

void PSloop(void) 

void PSlt(void) 
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void PSmachportdevice(int w, int h, int bbox\], int bboxSize, float matrix]}, char *phost, 

char *pport, char *ppixelDicty 

void PSmakefont(void) 

void PSmakepattern(void) 

void PSmark(void) 

void PSmatrix(void) 

void PSmaxlength(int *plength ) 

void PSmod(void) 

void PSmonitor(void) 

void PSmoveto(float x, float y) 

void PSmovewindow(float x, float y, userobject window ) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSmul(void) 

void PSne(void) 

void PSneg(void) 

void PSnewinstance(void)^ 

void PSnewpath(void) 

void PSnextrelease(int size, char stringU^ 

void PSnoaccess(void) 

void PSnot(void) 

void PSnotify(void) 

void PSnull(void) 

void PSnulldevice(void) 

void PSobscurccursor(void) t 

void PSor(void) 

void PSorderwindow(int place, userobject otherWindow, userobject window) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSosname(int size, char string]])^ 

void PSostype(int *ptype)^ 

void PSpackedarray(void) 

void PSpathbbox(float *pll x , float *plly, float *pur x , float *pur y ) 

void PSpathforall(void) 

void PSplacewindow(float x, float y, float width, float height, userobject window) 

Warning: Don’t use this function if you’re using the Application Kit. 
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void PSplaysound(char *name, int priority 

void PSpop(void) 

void PSposteventbycontext(int type, float jc , float y, int time, int flags, int window, int subtype, 

int datal, int data2, int context, boolean *psuccess 

void PSprint(void) 

void PSprinteventtimes(void) 

void PSprintobject(int code) 

void PSproduct(void) 

void PSprompt(void) 

void PSpstack(void) 

void PSput(void) 

void PSputinterval(void) 

void PSquit(void) 

void PSrand(void) 

void PSrcheck(boolean *pflag ) 

void PSrcurveto(float jc , float y, float x 2 , float y 2 , float x 3 , float y 3 ) 

void PSread(boolean *pflag) 

void PSreadhexstring(boolean *pflag ) 

void PSreadimage(void)^ 

void PSreadline(boolean *pflag) 

void PSreadonly(void) 

void PSreadstring(boolean *pflag) 

void PSrealtime(int *pi) 

void PSrectclip(float jc , float y, float width, float height ) 

void PSrectfill(float x, float y, float width, float height ) 

void PSrectstroke(float jc , float y, float width, float height ) 

void PSrectviewclip(float jc , float y, float width, float height ) 

void PSrenamefile(char *old, char *new) 

void PSrepeat(void) 

void PSresetfile(void) 

void PSresourceforalI(char * category ) 

void PSresourcestatus(char *key, char * category, int *b) 

void PSrestore(void) 
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void PSrevealcursor(void)^ 

void PSreversepath(void) 

void PSrevision(int *n) 

void PSrightbracket(void) 

void PSrightbuttondown(boolean *pflag) f 

void PSrightright(void) 

void PSrightstilldown(int eventNum, boolean *pflag )’*’ 

void PSrlineto(float x, float y) 

void PSrmoveto(float x, float y) 

void PSrootfont(void) 

void PSroll(int n, int j) 

void PSrotate(float angle) 

void PSround(void) 

void PSrrand(void) 

void PSrun(char *name) 

void PSsave(void) 

void PSscale(float sx, float sy) 

void PSscalefont(float size ) 

void PSscheck(boolean *pflag) 

void PSscreenlist(int context , int count, int windows^ 

void PSscreentobase(float x, float y, float *px, float *pyY 

void PSscreentocurrent(float x, float y, float *px, float *pyY 

void PSsearch(boolean *pflag) 

void PSselectfont(char *name, float scale ) 

void PSsendboolean(boolean flag) 

void PSsendchararray(char stringW, int size) 

void PSsendfloat(float value) 

void PSsendfloatarray(float array[\, int size) 

void PSsendint(int value) 

void PSsendintarray(int arrayW, int size) 

void PSsendstring(char * string ) 

void PSserialnumber(int *n ) 
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void PSsetactiveapp(int context) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSsetalpha(float coverage 

void PSsetautofill(boolean flag, userobject window)* 

void PSsetbbox(float ll x , float ll y float ur x , float ur y ) 

void PSsetblackgeneration(void) 

void PSsetcachedevice(float w x , float w y float ll x , float ll y float ur x , float ur y ) 

void PSsetcachelimit(float num) 

void PSsetcacheparams(void) 

void PSsetcharwidth(float w x , float wp 

void PSsetcmykcolor(float c, float m, float y, float k) 

void PSsetcolor(void) 

void PSsetcolorrendering(void) 

void PSsetcolorscreen(void) 

void PSsetcolorspace(void) 

void PSsetcolortransfer(void) 

void PSsetcursor(float x, float y, float mx, float my)* 

void PSsetdash(float pattern [], int size, float offset) 

void PSsetdefaultdepthlimit(int limit)' 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSsetdevparams(void) 

void PSseteventmask(int mask, userobject window) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSsetexposurecolor(void)^ 

void PSsetfileposition(int pos) 

void PSsetflat(float ./fatness) 

void PSsetflushexposures(boolean flag)* 

void PSsetfont(userobject font) 

void PSsetframebuffertransfer(void) 

void PSsetglobal(int b) 

void PSsetgray(float num) 

void PSsetgstate(userobject gstate) 

void PSsethalftone(void) 

void PSsethalftonephase(float a:, float y) 
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void PSsethsbcoIor(float hue, float sat, float brt) 

void PSsetinstance(boolean flag)'' 

void PSsetlinecap(int linecap ) 

void PSsetlinejoin(int linejoin) 

void PSsetlinewidth(float width) 

void PSsetmatrix(void) 

void PSsetmiterlimit(float limit) 

void PSsetmouse(float x, float 

void PSsetobjectformat(int code) 

void PSsetoverprint(int b) 

void PSsetowner(userobject context, userobject window)^ 

void PSsetpacking(boolean flag) 

void PSsetpagedevice(void) 

void PSsetpattern(int patternDict) 

void PSsetrgbcoIor(float red, float green, float blue) 

void PSsetscreen(void) 

void PSsetsendexposed(boolean flag, userobject window)'' 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSsetsharcd(boolean//<3g) 

void PSsetshowpageprocedure(int win)'' 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSsetstrokeadjust(boolean flag) 

void PSsetsystemparams(void) 

void PSsettrackingrectffloat x, float y, float width, float height, boolean leftFlag, 

boolean rightFlag, boolean inside, int userData, int trectNum, 
userobject gstate)'' 

void PSsettransfer(void) 

void PSsetucacheparams(void) 

void PSsetundercolorremoval(void) 

void PSsetuserparams(void) 

void PSsetvmthreshold(int i) 

void PSsetwaitcursorenabled(boolean flag)' 

void PSsetwindowdepthlimit(int limit, userobject window 

Warning: Don’t use this function if you’re using the Application Kit. 
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void PSsetwindowdict(userobject window ) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSsetwindowlevel(int level, userobject window)" 

void PSsetwindowtype(int type, userobject window 

Warning: Don’t use this function if you’re using the Application Kit. 

void PSset\vriteblock(int flag) 1 ' 

void PSshareddict(void) 

void PSSharedFontDirectory(void) 

void PSshow(char * string) 

void PSshowcursor(void)^ 

void PSshowpage(void) 

Warning: This function is different in NeXTSTEP. 

void PSsin(void) 

void PSsizeimage(float x, float y, float width, float height, int *ppixels\Vide, int *ppixelsHigh, 

int *pbitsPerSample, float matrix[], boolean *pmultiProc, 
int *pnColors) 1 ' 

void PSsqrt(void) 

void PSsrand(void) 

void PSstack(void) 

void PSStandardEncoding(void) 

void PSstart(void) 

void PSstartjob(int b, char * password) 

void PSstatus(boolean *pflag) 

void PSstatusdict(void) 

void PSstilldown(int eventNum, boolean *pflag )' 

void PSstop(void) 

void PSstopped(void) 

void PSstore(void) 

void PSstring(int length) 

void PSstringwidth(char * string , float *px, float *py) 

void PSstroke(void) 

void PSstrokepath(void) 

void PSsub(void) 

void PSsystemdict(void) 
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void PStermwindow(userobject window) 

Warning: Don’t use this function if you’re using the Application Kit. 

void PStoken(boolean *pflag) 

void PStransform(float jc, float y, float *px, float *py) 

void PStranslate(float jc, float y) 

void PStrue(void) 

void PStruncate(void) 

void PStype(void) 

void PSuappend(char nums[], int n, char ops[], int l) 

void PSucache(void) 

void PSucachestatus(void) 

void PSueofill(char nums[], int n, char ops[], int l) 

void PSufill(char nums [], int n, char ops[], int /) 

void PSundef(char *name) 

void PSundefinefont(char *name ) 

void PSundefineresource(char *key, char * category ) 

void PSundefineuserobject(int index) 

void PSupath (boolean flag) 

void PSuserdict(void) 

void PSuserobject(void) 

void PSusertime(int *pmillisecs) 

void PSustroke(char nums [], int n, char ops\], int l) 

void PSustrokepath(char nums[], int n, char ops[], int l) 

void FSversion(int bufsize, char buf[\) 

void PSviewclip(void) 

void PSviewclippath(void) 

void PSvmreclaim(int code) 

void PSvmstatus(int *plevel, int *pused, int *pmax) 

void PSwait(void) 

void PSwcheck(boolean *pflag) 

void PSwhere(boolean *pflag) 

void PSwidthshow(float x, float y, int c, char * string ) 
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void PSwindow(float jc, float y, float width, float height, int type, int *pwindow) 
Warning: Don’t use this function if you’re using the Application Kit. 

void PSwindowdevice(userobject window)^ 

void PSwindowdeviceround(userobject window 

void PSwindowlist(int context, int count, int windows[]y 

void PSwrite(void) 

void PSwritehexstring(void) 

void PSwriteobject(int code ) 

void PSvvritestring(void) 

void PSwtranslation(float *px, float *py) 

void PSxcheck(boolean *pflag) 

void PSxor(void) 

void PSxshow(char * string, float numArray[], int size ) 

void PSxyshow(char * string, float numArray[], int size) 

void PSyield(void) 

void PSyshow(char * string, float numArrayW, int size ) 
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Client Library Functions 


Controlling a PostScript Execution Context 


Create a context 


DPSContext 

DPSContext 

DPSContext 

DPSContext 

void 


DPSCreateContext(const char *hostName, const char *serverName, 
DPSTextProc textProc, DPSErrorProc errorProc)^ 
DPSCreateContextWithTimeoutFromZone(const char *hostName, 
const char *serverName, DPSTextProc textProc, 

DPSErrorProc errorProc, int timeout, NXZone *zone )' 
DPSCreateNonsecureContext(const char *hostName, const char *serverName, 
DPSTextProc textProc, DPSErrorProc errorProc, int timeout, 
NXZone *zoneY 

DPSCreateStreamContext(NXStream * stream, int debugging, 

DPSProgramEncoding progEnc, DPSNameEncoding nameEnc, 
DPSErrorProc errorProc 
DPSDestroyContext(DPSContext context) 


Create a child context 

int DPSChainContext(DPSContext parent, DPSContext child) 

void DPSUnchainContext(DPSContext context) 


Access the current context 

void DPSSetContext(DPSContext context) 

DPSContext DPSGetCurrentContext(void) 

Control a context 

int DPSSynchronizeContext(DPSContext context, int enableFlagY 

void DPSWaitContext(DPSContext context) 

void DPSAsynchronousWaitContext(DPSContext context, DPSPingProc handler, 

void *userData) 

Warning: The following two context-controlling functions aren’t implemented in NeXTSTEP 

void DPSInterruptContextO 

void DPSResetContextQ 
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Extract space from a context 

DPSSpace DPSSpaceFromContext(DPSContext context) 

Destroy a space and all contexts in it 

void DPSDestroySpace(DPSSpace space ) 


Sending Data to the Window Server 


Send PostScript code to the Window Server 

void DPSWritePostScript(DPSContext context, const void *buf, int count) 

void DPSWriteData(DPSContext context, const void *buf, unsigned int count) 

void DPSPrintf(DPSContext context, const char *format ,...) 

void DPSFlushContext(DPS Context context) 

void DPSFlush(void)^ 

void DPSSendEOF(DPSContext context 

Send an encoded PostScript path to the Window Server 

void DPSDoUserPath(void *coords, int numCoords, DPSNumberFormat numType, 

unsigned char *ops, int numOps, void *bbox, int action)^ 
void DPSDoUserPathWithMatrix(void *coords, int numCoords, 

DPSNumberFormat numType, unsigned char *ops, int numOps, 
void *bbox, int action, float matrix[6]f 


User Objects and User Names 


Create a user object 

int DPSDefineUserObject(int index)' 

void DPSUndefineUserObject(int index)' 


Access the system and user name tables 

void DPSMapNames(DPSContext context, unsigned int numNames, 

const char *const *nameArray, long int *const *numPtrArray) 
const char * DPSNameFromIndex(int index) 

const char * DPSNameFromTypeAndIndex(short type, int index )’*’ 
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Event-Handling 


Access events from the Window Server 

int DPSGetEvent(DPSContext context, NXEvent *anEvent, int mask, double timeout, 

int threshold 

int DPSPeekEvent(DPS Context context, NXEvent *anEvent, int mask, double timeout, 

int threshold 

void DPSDiscardEvents(DPSContext context, int mask)^ 

Coalesce events 

int DPSSetTracking(int/fag)' 

Set the event-filter function 

DPSEventFilterFunc DPSSetEventFunc(DPSContext context, DPSEventFilterFunc func ■)’*’ 

Create an event 

int DPSPostEvent(NXEvent *anEvent, int atStartf 

Create a timed entry 

DPSTimedEntry DPSAddTimedEntry(double period, DPSTimedEntryProc handler, 

void *userData, int priority)^ 

void DPSRemoveTimedEntry(DPSTimedEntry teNumbeff 

Initiate a count down for the wait cursor 

void DPSStartWaitCursorTimer(voidV 

Allow dead key processing 

void DPSSetDeadKeysEnabled(DPSContext context, int flagrf 

Generate an event mask for an event type 

int NX_EVENTCODEMASK(int type) 
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File and Port Monitoring 


Monitor a file descriptor 

void DPSAddFD(int/d, DPSFDProc handler , void *userData, int priority 

void DPSRemoveFD(int fdy 

Monitor a Mach port 

void DPSAddPort(port_t newPort, DPSPortProc handler, int maxSize, void *userData, 

int priority)^ 

void DPSRemovePort(port_t port) 1 

Set the notify port call-back function 

void DPSAddNotifyPortProc(DPSPortProc handler, void *userData 

void DPSRemoveNotifyPortProc(DPSPortProc handler 


Text-Handling 


Set the text call-back functions 

DPSTextProc DPSSetTextProc(DPSContext context, DPSTextProc tp) 

DPSTextProc DPSSetTextBackstop(DPSTextProc textProc ) 

DPSTextProc DPSGetCurrentTextBackstop(vo/<i) 


Debugging and Error-Handling 


Trace data and events 

int DPSTraceContext(DPSContext context, int flag)* 

void DPSTraceEvents(DPSContext context, int flag)'' 
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Handle errors 


DPSErrorProc 

void 

void 

DPSErrorProc 

void 

void 


DPSSetErrorProc(DPSContext context, DPSErrorProc ep) 
DPSDefaultErrorProc(DPS Context context, DPSErrorCode errorCode, 
long unsigned int argj, long unsigned int arg 2 ) 
DPSSetErrorBackstop(DPSErrorProc errorProc ) 
DPSGetCurrentErrorBackstop(voiJ) 

DPSPrintError(FILE *fp, const DPSBinObjSeqRec error)'' 
DPSPrintErrorToStream(NXStream * stream, const DPSBinObjSeqRec error)' 


Functions Used by pswrap 


Wait for return values from the Window Server 

void DPSAwaitReturnValues(DPSContext context) 

Write strings in binary object sequence 

void DPSWriteStringChars(DPSContext context, const char *buf, unsigned int count) 

Write PostScript code in a specified format 

void DPSWriteiypedObjectArray(DPSContext context, DPSDefinedType type, 

const void *array, unsigned int length) 

Begin a new binary object sequence 

void DPSBinObjSeqWrite(DPSContext context, const void *buf, unsigned int count ) 

Define information expected from the PostScript interpreter 

void DPSSetResultTable(DPSContext context, DPSResults table, unsigned int length ) 

Update a context's name map from the client library's name map 

void DPSUpdateNameMap(DPSContext context) 
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Types and Constants 


Defined Types 


DPSContextRec 

typedef struct _t_DPSContextRec { 
char *priv; 

DPSSpace space; 

DPSProgramEncoding programEncoding; 
DPSNameEncoding nameEncoding; 
struct _t_DPSProcsRec const * procs; 
void (*textProc)(); 
void (*errorProc)(); 

DPSResults resultTable; 
unsigned int resultTableLength; 
struct _t_DPSContextRec *chainParent, *chainChild; 
DPSContextType type; 

} DPSContextRec, *DPSContext; 

DPSContextType 

typedef enum { 

dps_machServer, 
dps_fdServer, 
dps_stream 
} DPSContextType; 


DPSErrorCode 

typedef enum _DPSErrorCode { 

dps_err_ps = DPS_ERROR_BASE, 

dps_err_nameTooLong, 

dps_err_resultTagCheck, 

dps_err_resultTypeCheck, 

dps_err_invalidContext, 

dps_err_select = DPS_NEXT_ERROR_BASE, 

dps_err_connectionCIosed, 

dps_err_read, 

dps_err_write, 
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dps_err_invalidFD, 

dps_err_inva!idTE, 

dps_err_invalidPort, 

dps_err_outOfMemory, 

dps_err_cantConnect 

} DPSErrorCode; 

DPSEventFilterFunc 

typedef int (*DPSEventFilterFunc)(NXEvent *ev ); 

DPSFDProc 

typedef void (*DPSFDProc)( int fd, void *userData ); 

DPSIMumberFormat 

typedef enum _DPSNumberFormat { 

#ifdef _BIG_ENDIAN__ 
dps_float = 48, 
dpsjong = 0, 
dps_short = 32 

#else 

dps_float = 48+128, 
dpsjong = 0+128, 
dps_short = 32+128 

} DPSNumberFormat; 

DPSPingProc 

typedef void (*DPSPingProc) 

(DPSContext ctxt, 
void *userData); 

DPSPortProc 

typedef void (^DPSPortProc) 

(msgjieader_t *msg, 
void *userDatci ); 

DPSTimedEntry 

typedef struct_DPSTimedEntry *DPSTimedEntry; 
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DPSHmedEntryProc 

typedef void (*DPSTimedEntryProc) 
(DPSTimedEntry timedEntry, 
double now, 
void *userData ); 

DPSUserPathAction 

typedef enum _DPSUserPathAction { 
dps_uappend =176, 
dps_ufill = 179, 
dps_ueofill =178, 
dps_ustroke =183, 
dps_ustrokepath = 364, 
dps_inufill = 93, 
dps_inueofill = 92, 
dps_inustroke = 312, 
dps_def = 51, 
dps_put =120 

} DPSUserPathAction; 

DPSUserPathOp 

typedef enum _DPSUserPathOp { 
dps_setbbox = 0, 
dps_moveto, 
dps_rmoveto, 
dps_lineto, 
dps_rlineto, 
dps_curveto, 
dps_rcurveto, 
dps_arc, 
dps_arcn, 
dps_arct, 
dps_closepath, 
dps_ucache 

} DPSUserPathOp; 

NXCoord 

typedef float NXCoord 
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NXEvent 


typedef struct _NXEvent { 
int type; 

NXPoint location; 
long time; 
int flags; 

unsigned int window; 
NXEventData data; 
DPSContext ctxt; 

} NXEvent, *NXEventPtr; 


NXEventData 

typedef union { 
struct { 

short eventNum; 
int click; 

unsigned char pressure; 

} mouse; 
struct { 

short repeat; 
unsigned short charSet; 
unsigned short charCode 
unsigned short keyCode; 
short keyData; 

} key; 
struct { 

short eventNum; 
int trackingNum; 
int userData; 

} tracking; 
struct { 

short reserved; 
short subtype; 
union { 
float F[2]; 
long L[2]; 
short S[4]; 
char C[8]; 

} misc; 

} compound; 

} NXEventData; 
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NXPoint 


typedef struct _NXPoint { 
NXCoord x; 
NXCoordy; 

} NXPoint; 

NXSize 

typedef struct _NXSize { 
NXCoord width; 
NXCoord height; 

} NXSize; 


Symbolic Constants 


All Contexts 

DPS__ALLCONTEXTS 


Alpha Constants 

NXJDATA 

NX.ONES 


Character Set Values 

NX_ASCIISET 

NX_SYMBOLSET 

NX_DINGBATSSET 
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Compositing Operations 


NXJXEAR 

NX_COPY 

NX_SOVER 

NX_SIN 

NX_SOUT 

NX_SATOP 

NX_DOVER 

NX_DIN 

NX_DOUT 

NX_DATOP 

NX_XOR 

NX_PLUSD 

NX_HIGHLIGHT 

NX_PLUSL 


Error Code Bases 

dps_error_base 

dps_next_error_base 


Event Types 


Meaning 


NX.NULLEVENT 

NXJLMOUSEDOWN 

NX_LMOUSEUP 

NX_LMOUSEDRAGGED 

NX_MOUSEDOWN 

NX_MOUSEUP 

NX_MOUSEDRAGGED 

NX_RMOUSEDOWN 

NX_RMOU S EUP 

NX_RMOUSEDRAGGED 

NX_MOUSEMOVED 

NX_MOUSEENTERED 

NX_MOU SEEXITED 

NX_KEYDOWN 

NX_KEYUP 

NX_FLAGSCHANGED 

NX_KITDEFINED 

NX_S YSDEFINED 

NX_APPDEFINED 

NX_TIMER 

NX_CURSORUPDATE 

NX_JOURNALEVENT 


A non-event 

Left mouse-down 

Left mouse-up 

left mouse-dragged 

Same as NX_LMOUSEDOWN 

Same as NX_LMOUSEUP 

Same as NXJLMOUSEDRAGGED 

Right mouse-down 

Right mouse-up 

Right mouse-dragged 

Mouse-moved 

Mouse-entered 

Mouse-exited 

Key-down 

Key-up event 

Flags-changed 

Appkit-defined 

System-defined 

Application-defined 

Timer used for tracking 

Cursor tracking 

Event used by journaling 
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The smallest-valued event constant 
The greatest-valued event constant 
A value that includes all event types 


NX_FIRSTEVENT 

NX.LASTEVENT 

NX_ALLEVENTS 


Event Type Masks 

NX_NULLEVENTMASK 

NX_LMOUSEDOWNMASK 

NX_LMOUSEUPM ASK 

NX_RMOUSEDOWNMASK 

NX_RMOUSEUPMASK 

NX_MOUSEMOVEDMASK 

NX_LMOUSEDRAGGEDMASK 

NX_RMOUSEDRAGGEDMASK 

NX_MOUSEENTEREDMASK 

NX_MOUSEEXITEDMASK 

NX_KEYDOWNMASK 

NX_KEYUPMASK 

NX_FLAGSCHANGEDMASK 

NX_KITDEFINEDMASK 

NX.APPDEFINEDMASK 

NX_S Y SDEFINEDM ASK 

NX_TIMERMASK 

NX_CURSORUPDATEMASK 

NX_MOUSEDOWNMASK 

NX_MOUSEUPMASK 

NX_MOUSEDRAGGEDMASK 

NX.JOURNALEVENTMASK 


Forever 

NX.FOREVER 
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Keyboard State Flags Masks 

NX_ALPHASHIFTMASK 

NX_SHIFTMASK 

NX_CONTROLMASK 

NX_ALTERNATEM AS K 

NX_COMM ANDMAS K 

NX_NUMERICPADMASK 

NX_HELPM AS K 

NX.NEXTCTRLKEYMASK 

NX_NEXTLSHIFTKEYMASK 

NX_NEXTRSHIFTKEYMASK 

NX.NEXTLCMDKEYMASK 

NX_NEXTRCMDKEYMASK 

NX_NEXTLALTKEYMASK 

NX_NEXTRALTKEYMASK 


Event Flags Masks 

NX_STYLUSPROXIMITYMASK 

NX_NONCOALSESCEDMASK 


Meaning 

Shift lock 
Shift key 
Control key 
Alt key 
Command key 
Number pad key 
Help key 
Control key 
Left shift key 
Right shift key 
Left command key 
Right command key 
Left alt key 
Right alt key 

Meaning 

Stylus is in proximity (for tablets) 
Event coalescing disabled 


Window Backing Types 

NX_RETAINED 

NX.NONRETAINED 

NXJBUFFERED 


Window Screen List Placement 

NX_ABOVE 

NXJBELOW 

NX_OUT 
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Distributed Objects 


Classes 


IMXConnection 


Inherits From: NXInvalidationNotifier : Object 

Conforms To: NXSenderlsInvalid 

NXReference (NXInvalidationNotifier) 

Establishing a Connection 

+ (NXProxy *)connectToName:(const char *)n Connects to the named object 

+ (NXProxy *)connectToName:(const char *)n Connects to the named object 

fromZone:(NXZone *)z 

+ (NXProxy *)connectToName:(const char *)n Connects to the named object 
onHost: (const char *)h 

+ (NXProxy *)connectToName:(const char *)n Connects to the named object 
onHost:(const char *)h 
fromZone:(NXZone *)z 

+ (NXProxy *)connectToPort:(NXPort *)p Connects over the specified port 

+ (NXProxy *)connectToPort:(NXPort *)p Connects over the specified port 

fromZone:(NXZone *)z 
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+ (NXProxy *)connectToPort:(NXPort *)aPort 
withInPort:(NXPort *)itiPort 

+ (NXProxy *)connectToPort:(NXPort *)aPort 
withInPort:(NXPort *)inPort 
fromZone:(NXZone *)z 

Ascertaining Connections 

+ connections:(List *)/ 

Registering an Object 

+ registerRooUanObject 

+ registerRoo tianObject 

fromZone:(NXZone *)z 

+ registerRoo UanObject 

withName:(const char *)n 

+ rcgisterRooUanObject 

withName: (const char *)n 
fromZone:(NXZone *)z 

Eliminating References 

+ removeObject :anObject 

Invalidation 

+ unregisterForlnvalidationNotification: 
anObject 

Statistics 

+ (int)messagesReceived 

Timeouts 

+ setDefaultTimeout:(int)t 

+ (int)defauItTimeout 

- setInTimeout:(int)t 

- setOutTimeout:(int)t 

- (int)inTimeout 

- (int)outTimeout 


Connects over the specified port 
Connects over the specified port 


Returns all connections 


Establishes a root object 
Establishes a root object 

Establishes a named root object 

Establishes a named root object 


Removes an object from all connections 


Unregisters an object for notifications 


Number of messages received over connection 


Sets default timeout for all connections 

Returns default timeout for all connections 

Sets in timeout 

Sets out timeout 

Returns in timeout 

Returns out timeout 
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Zone Usage 

+ setDefaultZone: (NXZone *)zone 

- (NXZone *)defaultZone 

Assigning a Delegate 

- setY)e\egate:anObject 

- delegate 

Returning Port Objects 

- (NXPort *)inPort 

- (NXPort *)outPort 

Getting and Setting the Root Object 

- rootObject 

- setRooUanObject 

Imported and Exported Objects 

- (List *)remoteObjects 

- (List *)localObjects 

Returning a Proxy 

- getLoca \:anld 

- newRemote:(unsigned)anC%‘ect 

withProtocol:(Protocol *)p 

Running a Connection 
-run 

- runWithTimeout:(int)/ 

- runlnNewThread 

- runFromAppKit 

-runFromAppKitWithPriority:(int)/?n'<9nYy 

Freeing an NXConnection Instance 

-free 


Sets default zone for all connections 
Returns default zone for all connections 


Sets the connection’s delegate 
Returns the connection’s delegate 


Returns the connection’s in port 
Returns the connection’s out port 


Returns the connection’s root object 
Sets the connection’s root object 


Returns the connection’s remote proxies 
Returns the connection’s local proxies 


Returns an object’s local proxy 
Creates a remote proxy for an object 


Runs the connection and blocks 
Runs the connection for a while 
Runs the connecion asynchronously 
Runs the connection from DPS client 
Runs the connection from DPS client 


Frees the connection 
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NXProxy 


Inherits From: none 

Conforms To: NXReference 

NXTransport 

Counting References 

- addReference 
-free 

- references 

Returning the proxy's connection 

- connectionForProxy 

Freeing an NXProxy instance 

- freeProxy 

Determining if an object is a proxy 

- isProxy 

Specifying a protocol 

- setProtocolForProxy:(Protocol *)proto 


Adds a reference 
Eliminates a reference 
Returns number of references 


Returns the proxy’s connection 


Frees the proxy but not its real object 


Identifies the receiver as a proxy 


Sets the proxy’s protocol for efficiency 


Object Additions 


Making Objects Distributable 

- encodeRemotelyFor: Transports an object using a proxy 

(NXConnection *)connection 
freeAfterEncoding:(BOOL *)flagp 
isBycopy:(BOOL )isBycopy 

- (BOOL)isProxy Identifies the receiver as an object 
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Protocols 


NXDecoding 


Adopted By: A private class that decodes data sent across a connection 


Methods 

- decodeBytes:(void *)bytes 

count: (int )count 

- decodeData:(void *)d 

ofType:(const char *)t 

- decodeMachPort:(port_t *)pp 

- decodeObject 

- decodeVM:(void **)bytes 

count:(int *)count 


Decodes untyped data 

Decodes typed data 

Decodes a Mach port 
Decodes an object 
Decodes virtual memory pages 


NXEncoding 


Adopted By: A private class that encodes data across a connection 

Methods 


- encodeBytes:(const void *)bytes 
count: (int )count 

Encodes untyped data 

- encodeData:(void *)data 

ofType:(const char *)type 

Encodes typed data 

- encodeMachPort:(port_t)port 

Encodes a Mach port 

- encodeObject:anC%ecr 

Encodes an object as a proxy 

- encodeObjectBycopy :anObject 

Encodes a copy of an object 

- encodeYM: (const void *)bytes 
count: (int )count 

Encodes virtual memory pages 
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IMXTransport 


Adopted By: List (common classes) 

NXData (Mach Kit) 

NXPort (Mach Kit) 

NXProxy 

Methods 

- encodeRemotelyFor: Determines what to encode across a connection 

(NXConnection *)connection 
freeAfterEncoding:(BOOL *)flagp 
isBycopy:(BOOL )isBycopy 

- encodeUsing:(id <NXEncoding>)/?orta/ Encodes an object across a connection 

- decodeUsing: (id <NXDecoding>)/?orta/ Decodes an object over a connection 
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Types and Constants 


Defined Types 


NXRemoteException 

typedef enum { 

nx_remote_exception_base= 11000, 

NX_couldntSendException = 11001, 
NX_couldntReceiveException = 11002, 
NX_couldntDecodeArgumentsException = 11003, 
NX_unknownMethodException = 11004, 
NX_objectInaccessibleException = 11005, 
NX_objectNotAvailableException = 11007, 
NX_remoteInternalException = 11008, 
NX_multithreadedRecursionDeadIockException = 11009, 
NX_destinationInvalid =11010, 

NX_originatorInvalid = 11011, 

NX_sendTimedOut = 11012, 

NX_receiveTimedOut = 11013, 
NX_REMOTE_LAST_EXCEPTION = 11999 
} NXRemoteException; 


Symbolic Constants 


Timeout Constantst Value 

NX_CONNECTION_DEFAULT_TIMEOUT 15000 
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Indexing Kit 


Classes 


IXAttributeParser 

Inherits From: Object 

Initializing an Instance 
-init 

Managing Readers 

- setAttributeReaders:(List *)aList 

- getAttributeReaders:(List *)aList 

Managing Text Stream Types 

- (BOOL)understandsType:(const char *)aType 

- addSourceType:(const char *)aType 

- removeSourceType: (const char *)aType 


Initializes and returns a new IXAttributeParser 


Sets the IXAttributeReaders to those in aList, freeing the 
previous IXAttributeReaders 

Returns in aList the IXAttributeReaders 


Returns YES if streams or files of aType are parsed 
Sets aType as a type that will be parsed 
Unsets aType as a type that will be parsed 
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Managing Parse Options 


- setMinimumWeight:(unsigned int )anlnt Sets the 

- (unsigned int)minimumWeight Returns 

- setPercentPassed:(unsigned int )anlnt Sets the 

- (unsigned int)percentPassed Returns 

- setWeightingDomain:(IXWeightingDomain *)aDomain 

Sets the 

- (IXWeightingDomain *)weightingDomain Returns 

- setWeightingType:(IXWeightingType)an/rtr Sets the 

- (IXWeightingType)weightingType Returns 


minimum weight for a token to be included 
the minimum weight for a token to be included 
percent of tokens dropped 
the percent of tokens dropped 

weighting domain for calculating peculiarities 

the weighting domain 

type of weighting to calculate 

the type of weighting calculated 


Parsing Text 

- parseFile:(const char *) filename 

ofType:(const char *)aType 

- parseStream:(NXStream *)stream 

ofType:(const char *)aType 

- (NXStream *)analyzeFile:(const char *)filename 

ofType:(const char *)aType 

- (NXStream *)analyzeStream:(NXStream *)stream 

ofType:(const char *)aType 

- reset 


Parses the contents of filename if possible, adding the 
information to the attribute-value list 

Parses the contents of stream if possible, adding the 
information to the attribute-value list 

Parses the contents of filename if possible, adding the 
information and returning the analyzed stream 

Parses the contents of stream if possible, adding the 
information and returning the analyzed stream 

Clears all compiled information in the attribute-value list 


IXAttributeQuery 


Inherits From: Object 


Initializing an IXAttributeQuery 

- initQueryString:(const char *)aString 

andAttributeParser: (IXAttributeParser *)aParser 

Initializes a new IXAttributeQuery with aString as 
the query expression and aParser used to parse it 
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Accessing Attributes 


- (char *)attributeNames Returns the names of attributes in the query string 

- (IXAttributeParser *)attributeParser Returns the IXAttributeParser 


Retrieving the Query Expression 

- (const char *)queryString Returns the query string 

Evaluating the Query 

- (IXPostingList *)evaluateFor :anObject Evaluates the query string against anObject, returning the 

records that match in an IXPostingList 


IXAttributeReader 


Inherits From: Object 

Conforms To: IXAttributeReading 

Altering Words 

- (unsigned int)foldPlural:(char *)aString 

inLength:(unsigned int )aLength 

- (unsigned int)reduceStem:(char *)aString 

inLength:(unsigned int)aLength 

Setting Reader Options 

- setCaseFolded:(BOOL)//ag 

- (BOOL)isCaseFolded 

- setPluralsFolded:(BOOL)//ag 

- (BOOL)arePluralsFolded 

- setStemsReduced:(BOOL)//«g 

- (BOOL)areStemsReduced 

- setPunctuation: (const char *)aString 


Reduces aString to its singular form 
Reduces aString to its base or root form 


Sets whether uppercase letters are changed to lowercase 
Returns whether uppercase letters are changed to lowercase 
Sets whether plural words are reduced to singular 
Returns whether plural words are reduced to singular 
Sets whether words are reduced to base or root forms 
Returns whether words are reduced to base or root forms 
Sets the set of characters used to delimit tokens to aString 
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- (char *)punctuation 

- setS top Words: (const char *)stopWords 

- (char *)stop Words 


IXBTree 

Inherits From: Object 

Conforms To: IXBlockAndStoreAccess 

IXNameAndFileAccess 
IXComparatorSetting 
IXComparisonSetting 

Accessing IXBTree Information 

- (unsigned int)count 

- (unsigned int)keyLimit 

Affecting IXBTree Contents 

- empty 

- compact 

Optimizing Performance 

- optimizeForSpace 

- optimizeForTime 


Returns the set of characters used to delimit tokens 
Sets the words that are deleted from a stream 
Returns the words that are deleted from a stream 


Returns the number of key-value pairs in the IXBTree 
Returns the maximumn allowed length for a key 


Removes the contents of the IXBTree 

Compacts the IXBTree’s contents to consume less space 


Keeps the IXBTree small, making insertions slower but 
seeks faster 

Makes insertions faster, and seeks slower 
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IXBTreeCursor 


Inherits From: Object 

Conforms To: IXCursorPositioning 

Initializing an IXBTreeCursor 

- initWithBTree:(IXBTree *)aBTree Initializes a new IXBTreeCursor to move in aBTree 


Accessing the IXBTree 

- (IXBTree *)btree Returns the IXBTree that the cursor moves in 

Positioning with Hints 

- (BOOL)setKey:(void *)aKey Positions the IXBTreeCursor at aKey if possible, 

andLength:(unsigned mX)aLength using aHint to speed search; returns YES if aKey 

withHint: (unsigned int )aHint is found 

- (BOOL)getKey:(void **)aKey Returns the position of the cursor in aKey and aLengtiv, 

andLength:(unsigned int *)aLength also returning in aHint a hint that can be used to speed 

withHint:(unsigned int *)aHint later search; returns NO if the cursor is past the end of 

the IXBTree’s key space 


Accessing IXBTree Data 

- (BOOL)writeValue:(void *)aValue 

andLength:(unsigned int )aLength 

- writeRange:(void *)aRange 

atOffset: (unsigned mt)anOjfset 
forLength:(unsigned int )aLength 

- (unsigned int)readValue:(void **)aValue 

- (unsigned int)readRange:(void **)aRange 

ofLength:(unsigned int )aLength 
atOffset: (unsigned int )anOffset 

- remove Value 


Writes or inserts aValue at the cursor’s position 

Writes aRange into the value at the cursor’s position; 
if the cursor isn’t exactly on a key, raises an exception 

Reads the value at the cursor’s position and returns its 
length; slides forward if needed to get a value 

Reads a portion of the value at the cursor’s position and 
returns its length; if the cursor isn’t exactly on a key, 
raises an exception 

Removes the value at the cursor’s position; if the cursor 
isn’t exactly on a key, raises an exception 
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IXFileFinder 


Inherits From: Object 

Conforms To: IXBlockAndStoreAccess 

IXNameAndFileAccess 
IXFileFinderConfiguration 
IXFileFinderQueryAndUpdate 
NXReference 


Initializing an IXFileFinder 

- initInStore:(IXStore *)aStore 

atPath: (const char *)path 

- initFromBIock:(unsigned int )aHandle 

inStore:(IXStore *)aStore 
atPath: (const char *)path 

- initWithName:(const char *)aName 

inFile:(const char *) filename 
atPath: (const char *)path 

- initFromName:(const char *)aName 

inFile:(const char *)filename 
forWriting:(BOOL)/fag 
atPath:(const char *)path 


Initializes a new IXFileFinder in aStore to index files 
in path 

Reloads an IXFileFinder from block aHandle in aStore 
to index files in path 

Initializes a new IXFileFinder named aName in filename 
to index files in path 

Reloads an IXFileFinder stored under aName in filename, 
allowing writing back to the file according to flag, 
and set to index files in path 


IXFileRecord 

Inherits From: Object 

Conforms To: NXTransport 

Initializing a New Instance 

- initWithFiIeFinder:(IXFileFinder *)aFileFinder Initializes a new IXFileRecord for aFileFinder 

Getting the File Finder 

- (IXFileFinder *)fileFinder Returns the IXFileFinder that the IXFileRecord belongs to 
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Accessing File Attributes 


- setFilename:(const char *)aName 

- (const char *)filename 

- setFiletype:(const char *)aType 

- (const char *)filetype 

- setDescription:(const char *)aDescription 

- (const char *)description 

- setFiledate: (unsigned int )aDate 

- (unsigned int)filedate 

Accessing UNIX File Information 

- (const struct stat *)statBuffer 


Sets the filename that the IXFileRecord refers to to aName 
Returns the filename that the IXFileRecord refers to 
Sets the recorded type for the associated file to aType 
Returns the recorded type for the associated file 
Sets the description for the associated file to aName 
Returns the description for the associated file 

Sets the recorded creation date for the associated file to 
aDate 

Returns the recorded creation date for the associated file 


Returns the cached UNIX stat buffer for the associated file, 
or NULL if one hasn’t been cached 


IXLanguageReader 

Inherits From: IXAttributeReader : Object 


Getting Objects Associated with Languages 

+ readerForLanguage:(const char *)aLanguage 
+ domainForLanguage:(const char *)aLanguage 

Getting the Target Language 

+ (NXAtom)targetLanguage 
- (NXAtom)targetLanguage 


languages for which readers are installed 
IXLanguageReader subclass for aLanguage 

Returns an IXLanguageReader for aLanguage 
Returns an IXWeightingDomain for aLanguage 


Returns the target language of the subclass 
Returns the target language of the reader 


Conforms To: IXAttributeReading (IXAttributeReader) 

Getting Language Information 

+ (char *)installedLanguages Returns the 

+ (Class)classForLanguage:(const char *)aLanguage 

Returns the 
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Disabling Dynamic Loading 

+ disableLoading Disables dynamic loading of external language readers 


IXPostingCursor 

Inherits From: IXBTreeCursor : Object 

Conforms To: IXPostingExchange 

IXPostingOperations 
IXCursorPositioning (IXBTreeCursor) 

Methods 

This class declares no methods. 


IXPostingList 

Inherits From: List: Object 

Conforms To: IXPostingExchange 

NXTransport 

Initializing an IXPostingList 

- initWithSource:(id <IXRecordReading>)aS'0wrce Initializes a new IXPostingList to extract objects from 

aSource 

- initWithSource:(id <IXRecordReading>)<2Se>«rce 

andPostingsIn:(id <lXPostmgExch'dnge>)anObject 

Initializes a new IXPostingList to extract objects 

from aSource and initially contain the postings in anObject 
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Retrieving the Source 


- (id <IXRecordReading>)source 


Returns the archive from which objects are extracted 


Manipulating Objects by Handle 

- addHandle: (unsigned int )aHandle Adds a new posting to the end of the list 

with Weight: (unsigned int)aWeight 

- insertHand!e:(unsigned mi)aHandle Inserts a new posting at index 

withWeight:(unsigned mi)aWeight 
at:(unsigned int )index 

- replaceHandleAt:(unsigned int)index Replaces the posting at index with the information supplied 

with:(unsigned int )aHandle 
weight: (unsigned int )aWeight 


Manipulating Objects by id 

- addObjecUanObject 

withWeight:(unsigned int )aWeight 

- insertObjec tianObject 

withWeight:(unsigned int)aWeight 
at:(unsigned int)m dex 

- replaceObjectAt:(unsigned mt)index 

with :anObject 

weight: (unsigned int )aWeight 


Adds anObject to the end of the list with aWeight, but no 
posting handle 

Inserts anObject with aWeight at index, but without a 
posting handle 

Replaces the object at index with the object and weight 
supplied, but without a posting handle 


Manipulating Objects by Index 

- (unsigned int)indexForHandle:(unsigned int )handle 

Returns the index of the posting with handle handle 

- (unsigned intjhandleOfObjectAt: (unsigned \nt)index 

Returns the handle for the posting at index 

- (unsigned int)weightOfObjectAt:(unsigned int)index 

Returns the weight for the posting at index 


Sorting the Contents 

- sortByWeightAscending:(BOOL)/?ag Sorts the postings and objects by their weight 

- sortBySelector:(SEL)a 5 e/ector Sorts the postings and objects based on the return values 

ascending:(BOOL )flag of aSelector as sent to each object 
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IXPostingSet 


Inherits From: Object 

Conforms To: IXPostingExchange 

IXPostingOperations 


Initializing Instances 

- initCount:(unsigned int )count Inializes a new IXPostingSet to conatin count postings 

andPostings: (const IXPosting *)postings 

- initWithPostingsIn:<2tt0Zyecf Initializes a new IXPostingSet to contain the postings in 

anObject 


Setting the Postings 

- setCount:(unsigned int)count Sets the postings in the IXPostingSet to count postings, 

andPostings:(const IXPosting *)postings copying them if flag is YES 

by Copy : (BOOL)flag 

Accessing Postings by Position 

- (unsigned int)setPosition:(unsigned int)index Sets the selected posting to the one at position index 

Performing Set Operations 

- formUnionWithPostingsIn:(id <IXPostingExchange>)anOZ?/<?ct 

Performs a set union with the postings in anObject, altering 
the IXPostingSet’s contents but not anObject' s 

- formIntersectionWithPostingsIn:(id <IXPostingExchange>)anC%ecr 

Performs a set intersection with the postings in anObject, 
altering the IXPostingSet’s contents but not anObject' s 

- subtractPostingsIn:(id cIXPostingExchang &>)anObject 

Performs a set subtraction with the postings in anObject, 
altering the IXPostingSet’s contents but not anObject' s 
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IXRecordManager 


Inherits From: Object 

Conforms To: IXBlockAndStoreAccess 

IXNameAndFileAccess 
IXBlobWriting 
IXRecordDiscarding 
IXRecordWriting 
IXTransientAccess 
IXTransientMessaging 

Adding and Removing Attributes 

- addAttributeNamed: (const char *)aName 

forSelector:(SEL )aSelector 

- (BOOL)hasAttributeNamedr(const char *)aName 

- removeAttributeNamed:(const char *)aName 

Key Comparison 

- setComparisonFormat: (const char *)aFormat Sets the data format used for values in the attribute named 

forAttributeNamed: (const char *)aName aName 

- (const char *)comparisonFormatForAttributeNamed: (const char *)aName 

Returns the data format used for values in the attribute 
named aName 

- setComparator:(IXComparator *)aComparator Sets the comparator function and context used for values 

andContext: (const void *)aContext in the attribute named aName 

for AttributeNamed: (const char *)aName 

- getComparator:(IXComparator **)aComparator Returns the comparator function and context used for 

andContext:(const void **)aContext values in the attribute named aName 

forAttributeNamed:(const char *)aName 

Setting Attribute Targets 

- setTargetClass :aClass 

for AttributeNamed: (const char *)aName 

- getTargetName:(const char **)aName 

andVersion:(unsigned int *)targetVersion 
forAttributeNamed:(const char *)aName 


Restricts the attribute named aName to contain references 
only to objects of class aClass (or a subclass) 

Returns the name and class version of the target class for 
the attribute named aName 


Creates an attribute named aName, based on the values 
returned by objects sent aSelector 

Returns whether an attribute named aName exists 
Removes the attribute named aName 
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Accessing Attributes 

- (IXPostingCursor *)cursorForAttributeNamed:(const char *)aName 

Returns an IXPostingCursor that may be used to search for 
values for the attribute named aName 

Getting Attribute Information 

- (SEL)selectorForAttributeNamed: (const char *)aName 

Returns the selector used to build the attribute named 
aName 

- (char *)attributeNames Returns the names of all attributes in the 

IXRecordManager 

Accessing Classes 

- (char *)cIassNames Returns the names of all classes that have instances stored 

in the IXRecordManager 

- (char *)attributeNamesForClass:aC/a l M Returns the names of the attributes in the 

IXRecordManager that contain references to instances 
of aClass (or a subclass) 

- (IXPostingList *)recordsForCIass:«C/£m Returns in an IXPostingList all instances in the 

IXRecordManager of aClass (or a subclass) 

Retrieving Discarded Records 

- (IXPostingList *)discards Returns in an IXPostingList all discarded records 

Setting Attribute Descriptions 

- setDescription: (const char *)aDescription 

forAttributeNamed: (const char *)aName 

- getDescription:(char **)aDescription 

forAttributeNamed: (const char *)aName 

Setting Parsers 

- setParser:(IXAttributeParser *)aParser Sets the IXAttributeParser used for the attribute named 

forAttributeNamed:(const char *)aName aName 

- (IXAttributeParser *)parserForAttributeNamed:(const char *)aName 

Returns the IXAttributeParser used for the attribute named 
aName 


Sets the description for the attribute named aName to 
aDescription 

Returns the description for the attribute named aName 
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IXStore 


Inherits From: Object 


Initializing, Copying, and Freeing Instances 

- init Initializes a new IXStore 

- copy Returns a copy of the IXStore that references the same 

storage 

- free Deallocates the IXStore, and all the storage if it’s not 

shared 


Creating, Copying, and Freeing Blocks 

- createBlock:(unsigned int *)aHandle 

ofSize:(unsigned intjjj'ze 

- (unsigned int)copyBlock:(unsigned int )aHandle 

atOffset:(unsigned mt)anOjfset 
forLength:(unsigned int )aLength 

- freeBlock:(unsigned int )aHandle 


Creates a block of size size and returns its identifier in 
aHandle 

Copies a portion of the block identified by aHandle and 
returns the copies identifier 

Frees the block identified by aHandle 


Opening and Closing Blocks 

- (void *)openBlock:(unsigned int )aHandle 

atOffset: (unsigned int )anOjfset 
forLength:(unsigned int)aLength 

- (void *)readBlock:(unsigned mt)aHandle 

atOffset: (unsigned mi)anOjfset 
forLength:(unsigned mt)aLength 

- closeBlock:(unsigned int )aHandle 

Managing Block Sizes 

- resizeBlock: (unsigned int )aHandle 

toSize:(unsigned int )aSize 

- (unsigned intjsizeOfBIock:(unsigned int )aHandle 


Opens a portion of the block identified by aHandle for 
writing if possible, otherwise raises an exception 

Opens a portion of the block identified by aHandle for 
reading if possible, otherwise raises an exception 

Closes the open block identified by aHandle 

Resizes the block identified by aHandle to aSize 
Returns the size of the block identified by aHandle 


Using Transactions 

- (unsigned int) star transaction 


Starts a new transaction and returns the nested level of 
transactions pending 
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- abortTransaction 

- commitTransaction 

- (BOOL)areTransactionsEnabled 

- (unsigned intjnestingLevel 

- (unsigned int)changeCount 

Aborts the current transaction 

Commits the changes made in the current transaction 

Returns YES if a transaction has ever been started 

Returns the nesting level of transactions pending 

Returns the number of commitTransaction and 
abortTransaction messages received by the 
instantiation 

Accessing the Contents 


-setContents:(vm_address_t)jomeConrenrj 
andLength: (vm_sizQ_t)aLength 

- getContents:(vm_address_t *)theContents 
andLength:(vm_size_t *)aLength 

Replaces the IXStore’s storage with that in someContents 

Returns in theContents and aLength the IXStore’s storage 
and its length 

Reducing Memory Consumption 


- compact 

Compacts the blocks of storage to take as little space as 
possible; delayed until all transactions are finished 


IXStoreBlock 


Inherits From: Object 

Conforms To: IXBlockAndStoreAccess 

NXReference 

Accessing the Block's Contents 

- (void *)openAtOffset:(unsigned int )anOffset 

forLength: (unsigned int )aLength 

- (void *)readAtOffset:(unsigned int )anOffset 

forLength: (unsigned int )aLength 

- (unsigned int)copyAtOffset:(unsigned int )anOffset 

forLength: (unsigned int )aLength 

- close 


Opens a portion of the block for writing if possible; raises 
an exception otherwise 

Opens a portion of the block for reading if possible; raises 
an exception otherwise 

Copies a portion of the block, returning the copy’s 
identifier 

Closes the block if it’s been opened 
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Managing the Block Size 

- resizeTo:(unsigned ini)size Resizes the block to size 

- (unsigned int)size Returns the size of the block 

Archiving an Object in an IXStoreBlock 

- readObject Unarchives the object previously archived into the block 

- writeObject:(unsigned int )anObject Archives anObject into the block 


IXStoreDirectory 

Inherits From: Object 

Conforms To: IXBlockAndStoreAccess 

IXNameAndFileAccess 


Adding Entries or Objects 

- addEntryNamed:(const char *)aName 

ofClass :aName 

- addEntryNamed:(const char *)aName 

ofClassraAfome 

atBlock:(IXBlockHandle)a//ara//e 

- addEntryNamed:(const char *)aName 

forOb jecUanObject 


Creates an instance of the store client class named aName, 
and stores it under aName 

Creates an instance of the store client class named aName, 
and stores it under aName in the block of the 
IXStoreDirectory’s IXStore identified by aHandle 

Stores the store client anObject under aName 


Removing Entries 

- freeEntryNamed:(const char *)aName 

- removeName:(const char *)aName 

- empty 

- reset 


Removes from the IXStore the object stored under aName 

Removes the reference to the object stored under aName, 
but doesn’t remove the object itself 

Empties all stored objects and names 

Removes all references to stored objects, but not the objects 
themselves 
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Getting Entries 

- (BOOL)hasEntryNamed:(const char *)aName 

- getBlock:(unsigned int *)aHandle 

ofEntryNamed:(const char *)aName 

- getClass:(id *)aClass 

ofEntryNamed: (const char *)aName 

- openEntryNamed: (const char *)aName 

- (const char * gentries 


Returns whether there’s an object stored under aName 
Gets the block identifier for the object stored under aName 

Gets the class object for the object stored under aName 

Activates and returns the object stored under aName 
Returns the stored names 


IXStoreFile 

Inherits From: IXStore : Object 

Initializing and Freeing Instances 
-init 

- initWithFile: (const char *) filename 

- initFromFile: (const char *) filename 

forWriting:(BOOL)/7ag 

-free 

Limiting the File Mapping Size 

- setSizeLimit: (vm_size_t)aLim/f 

- (vm_size_t)sizeLimit 

Getting File Information 

- (int)descriptor 

- (const char *)filename 


Initializes a new IXStoreFile in a temporary file 
Initializes a new IXStoreFile with a file named filename 

Initializes an IXStoreFile from existing storage m filename, 
allowing writing back to the file if flag is YES 

Frees the IXStoreFile, but doesn’t affect the storage file 


Sets the caching limit for the IXStoreFile to aLimit 
Returns the caching limit for the IXStoreFile 


Returns the file descriptor for the storage file 
Returns the name of the storage file 
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IXWeightingDomain 


Inherits From: Object 


Initializing Instances 

- initFromDomain:(NXStream *)stream 

- initFromHistogram:(NXStream *)stream 

- initFromWFTabIe:(NXStream *)stream 

Saving Domain Information 

- writeDomain:(NXStream *)stream 

- writeHistogram:(NXStream *)stream 

- writeWFTable:(NXStream *) stream 

Counting Tokens 

- (unsigned int)totalTokens 

- (unsigned int)uniqueTokens 

Retrieving Information about Tokens 

- (unsigned int)countForToken:(void *)aToken 

ofLength: (unsigned int )aLength 

- (unsigned int)rankForToken:(void *)aToken 

ofLength: (unsigned int)aLength 

- (float)frequencyOfToken:(void *)aToken 

ofLength: (unsigned int)aLength 

- (float)peculiarityOfToken:(void *)aToken 

ofLength: (unsigned int )aLength 
andF requency: (float )aFrequency 


Initializes a new IXWeightingDomain from domain format 
data in stream 

Initializes a new IXWeightingDomain from histogram 
format data in stream 

Initializes a new IXWeightingDomain from NeXTSTEP 
2.0 WFTable format data in stream 


Write domain format data to stream 

Writes histogram format data to stream 

Writes NeXTSTEP 2.0 WFTable format data to stream 


Returns the total number of tokens in the weighting domain 
Returns the total number of unque tokens 


Returns the number of occurrences of aToken in the domain 

Returns the ordinal rank of occurrences of aToken in the 
domain 

Returns the frequency of aToken in the domain 
Returns the peculiarity of aToken in the domain 
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Protocols 


IXAttributeReading 

Adopted By: IXAttributeReader 

Methods 

- (NXStream *)analyzeStream:(NXStream *)stream 

Analyzes the text in stream, returning a stream of lexed text 
in Attribute Reader Format 


IXBIobWriting 

Adopted By: IXRecordManager 

Methods 

- (BOOL)setValue:(const void *)aValue 

andLength: (unsigned int )aLength 
ofBlob: (const char *)blobName 
forRecord: (unsigned mi)aHandle 

- (BOOL)getValue:(void **)aValue 

andLength:(unsigned int *)aLength 
ofBlob:(const char *)blobName 
forRecord:(unsigned int )aHandle 


Stores aValue under blobName on behalf of the record 
identified by aHandle; returns YES on success, NO 
otherwise 

Retrieves the value and length for blobName on behalf of 
the record identified by aHandle ; returns YES on 
success, NO otherwise 
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IXBIockAndStoreAccess 


Adopted By: IXBTree, 

IXFileFinder, 

IXRecordManager, 

IXStoreBlock, 

IXStoreDirectory 

Initializing and Freeing a Client 

- initInStore:(IXStore *)aStore 

- initFromBlock: (unsigned \\\t)aHandle 

inStore:(IXStore *)aStore 

- freeFromStore 

+ freeFromBlock: (unsigned int )aHandle 
andStore:(IXStore *)aStore 

Retrieving the Block and Store 

- getBlock: (unsigned int *)aHandle 

andStore:(IXStore **)aStore 


IXComparatorSetting 

Adopted By: IXBTree 

Methods 

- setComparator:(IXComparator *)aComparator 

andContext:(const void *)aContext 

- getComparator:(IXComparator **)aComparator 

andContext:(const void **)aContext 


Initializes a new store client in aStore 

Initializes a store client from data previously stored in the 
block identified by aHandle in aStore 

Removes the store client’s storage from the IXStore and 
frees the run-time object 

Frees the data for the store client identified by aHandle in 
aStore, without necessarily creating an instance 


Gets the identifier of the block owned by the store client, 
and the IXStore that the block exists in 


Sets the function used to compare items; also 

provides aContext as arbitrary data to use in comparison 

Gets the comparator function and context 
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IXComparisonSetting 


Adopted By: IXBTree 

Methods 

- setComparisonFormat:(const char *)format Sets the data format of items compared by the receiver 

- (const char *)comparisonFormat Returns the data format of items compared 


IXCursorPositioning 


Adopted By: IXBTreeCursor 


Absolute Positioning 

- (BOOL)setKey:(void *)aKey 

andLength: (unsigned int )aLength 

- (BOOL)getKey:(void **)aKey 

andLength:(unsigned int *)aLength 


Sets the position of the receiver to aKey, if it exists, 
otherwise to where aKey would logically be; returns 
YES if aKey exists 

Gets the key for the receiver’s position and its length, 
sliding the receiver forward in the key space if needed 
and if possible; returns YES if the receiver ends up on 
a key 


Relative Positioning 

- (BOOL)setFirst 

- (BOOL)setNext 

- (BOOL)setLast 

- (BOOL)setPrevious 


Positions the receiver at the first key if there is one; returns 
YES if there is one, NO if not 

Moves the receiver forward one key value and returns YES 
if there’s a key there 

Positions the receiver at the last key if there is one; returns 
YES if there is one, NO if not 

Moves the receiver back one key value and returns YES if 
there’s a key there 
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Checking Positioning Success 


- (BOOL)isMatch 


Returns YES if the receiver is on akey, NO if it’s between 
two keys or off either end of the key space 


IXFileFinderConfiguration 


Adopted By: IXFileFinder 

Managing Attribute Parsers 

- setAttributeParsers:(List *)aList Sets the IXAttributeParsers used to parse files 

- getAttributeParsers:(List *)aList Returns in aList the IXAttributeParsers used to parse files 

Generating Descriptions 

- setGeneratesDescriptions : (BOOL)flag Sets whether descriptions are generated automatically for 

files indexed 

- (BOOL)generatesDescriptions Returns whether descriptions are generated automatically 

for files indexed 


Enabling Automatic Updating 

- setUpdatesAutomatically : (B OOlfiflag Sets whether the file finder automatically updates its 

indexes upon finding out of date references 

- (BOOL)updatesAutomatically Returns whether the file finder automatically updates its 

indexes 


Setting File System Options 

- setCrossesDeviceChanges:(BOOL)/fog Sets whether the file finder indexes or searches files on a 

different device from its root directory 

- (BOOL)crossesDeviceChanges Returns whether the file finder indexes or searches files on 

a different device from its root directory 

- setFollowsSymbolicLinks:(BOOL)//ag Sets whether the file finder follows symbolic links when 

building indexes 

- (BOOL)followsSymbolicLinks Returns whether the file finder follows symbolic links 

when building indexes 
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- setScansForModifiedFiles:(BOOL)/7ag Sets whether the file finder scans for files whose 

modification times have changed 

- (BOOL)scansForModifiedFiles Returns whether the file finder scans for modified files 


Ignoring Files 

- setIgnoredTypes:(const char *)types 

- (char *)ignoredTypes 

- setlgnoredNames: (const char *)names 

- (char *)ignoredNames 


Sets to types the types of files that won’t be indexed 
Returns the types of files that aren’t indexed 

Sets to names the literal, base names of files that won’t be 
indexed 

Returns the names of files that aren’t indexed 


IXFileFinderQueryAndUpdate 

Adopted By: IXFileFinder 

Getting the Target Directory 

- (const char *)rootPath Returns the base path for the file finder’s index 

Getting the Record Manager 

- recordManager Returns the object that stores the file finder’s 

IXFileRecords 


Performing Queries 


- (IXPostingList *)performQuery: (const char *)aQuery 

atPath: (const char *)path Evaluates aQuery for sender returning in an 

forSendensera/er IXPostingList the IXFileRecords that match 


- stopQueryForSenderisencfer 


Stops the query requested by sender 
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Updating Indexes 


- updateIndexAtPath:(const char *)path 

forSender ‘.sender 

- (BOOL)isUpdating 

- suspendUpdating 

- resumeUpdating 

- clean 

- reset 


Updates the indexes for files within path relative to the file 
finder’s root path 

Returns whether the file finder is updating its indexes 
Suspends updating of indexes 
Resumes updating of indexes 

Removes inaccurate or out of data information from 
indexes 

Completely empties indexes 


Methods Implemented by the Sender of a Query or Update 


- fileFinder:(IXFileFinder *)aFinder 

didFindFile:(IXFileRecord *)aRecord 

- fileFinder:(IXFileFinder *)aFinder 

didFindList:(IXPostingList *)aList 

- fileFinder:(IXFileFinder *)aFinder 

willAddFile:(IXFileRecord *)aRecord 


Asynchronously notifies the sender of a 

performQuery:atPath:forSender: message that 
aRecord matches the query 

Asynchronously notifies the sender of an 

performQuery:atPath:forSender: message that the 
IXFileRecords in a List match the query 

Asynchronously notifies the sender of an 

updateIndexAtPath:forSender: message that 
aRecord is about to be added to the index 


IXLexemeExtraction 


Adopted By: No NeXTSTEP classes. 


Lexing a Stream 

- (unsigned int)getLexeme:(char *)aString Puts the next lexeme from stream into aString 

inLength:(unsigned int )aLength 
fromStream:(NXStream *)stream 

Manipulating a Word/Lexeme 

- (unsigned int)foldCase:(char *)aString Reduces aString to lowercase letters 

inLength:(unsigned ini)aLength 
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IXNameAndFileAccess 


Adopted By: 


Incorporates: 


IXBTree, 

IXFileFinder, 

IXRecordManager, 

IXStoreDirectory 

IXB lockAndStore Access 


Initializing and Freeing a Client 

- initWithName: (const char *)aName 

inFile: (const char *) filename 

- initFromName:(const char *)aName 

inFile: (const char *)filename 

forWriting:(BOOL )flag 

- freeFromStore 

+ freeFromName:(const char *)aName 
andFile:(const char *)filename 


Initializes a new store client under aName in filename 

Initializes a store client from data previously stored under 
aName in filename ; if flag is YES, changes can be 
written back to the file 

Removes the store client’s storage from the IXStoreFile 
and frees the run-time object 

Frees the data for the store file client identified by aName in 
filename, without necessarily creating an instance 


Retrieving the Name and File 

- getName:(const char **)aName 

andFi!e:(const char **)filename 


Gets the name of the store client, and the name of the file 
that the data exists in 


IXPostingExchange 


Adopted By: IXPostingCursor 

IXPostingList 
IXPostingSet 


Methods 

- setCount:(unsigned int )count 

andPostings:(IXPosting *)postings 


Sets the receiver’s posting set to count postings 


7-24 Chapter 7: Indexing Kit 




- getCount: (unsigned int *)count 

andPostings:(IXPosting **)thePostings 


Gets the receiver’s postings and their amount 


IXPostingOperations 


Adopted By: IXPostingCursor 

IXPostingSet 

Manipulating Postings by Handle 

- (unsigned int)addHandle:(unsigned int )aHandle 

with Weight: (unsigned int)a Weight 

- removeHandle:(unsigned int )aHandle 

Getting the Number of Postings 

- (unsigned int)count 

Emptying a Posting Set 

- empty 

Traversing a Posting Set 

- (unsigned int)setHandle: (unsigned ini)aHandle 

- (unsigned int)getHandle:(unsigned int *)aHandle 

and Weight: (unsigned int *)aWeight 

- (unsigned int)setFirstHandle 

- (unsigned int)setNextHandle 


Adds a postings to the set of postings 
Removes a postings from the set 


Returns the number of postings in the set 


Empties all postings from the set 


Sets the selected posting to the one with aHandle and 
returns that handle, or 0 if aHandle isn’t in the set 

Gets the handle and weight of the selected posting 

Sets the selected posting to the first in the set and returns its 
handle, or 0 if there are no postings 

Sets the selected posting to the next in the set and returns 
its handle, or 0 if there are no more postings 
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IXRecordDiscarding 


Adopted By: IXRecordManager 

Discarding Records 

- discardRecord: (unsigned int )aHandle 

- reclaimRecord: (unsigned int )aHandle 

Removing Discarded Records 

- clean 


IXRecordReading 

Adopted By: No NeXTSTEP classes 

Methods 

- (unsigned int)count 

- readRecord:(unsigned \ni)aHandle 

fromZone:(NXZone *)zone 
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Discards the records identified by aHandle 
Reclaimes the discarded record identified by aHandle 


Permanently deletes all discarded records 


Returns the number of records in the archive 

Reads the record identified by aHandle and returns the 
corresponding object allocated from zone 




IXRecordTranscription 


Adopted By: No NeXTSTEP classes. 

Methods 

- sourc eiaTranscriber 

didReadRecord:(unsigned int)aHandle 

- source:aTranscriber 

will WriteRecord: (unsigned int )aHandle 

- finishReading 


Notifies the record identified by aHandle that it’s been read 

Notifies the record identified by aHandle that it’s going to 
be written 

Allows a record just read to reinitialize itself or provide a 
replacement 


IXRecordWriting 

Adopted By: IXRecordManager 

Incorporates: IXRecordReading 

Manipulating Records by Handle 

Adds anObject to the receiver’s archive 
Replaces the record identified by aHandle with anObject 

Removes from the archive the record identified by aHandle 

Empties the receiver’s archive of all records 


- (unsigned int)addRecord '.anObject 

- replaceRecord: (unsigned int )aHandle 

with '.anObject 

- removeRecord: (unsigned int) aHandle 

Emptying a Record Storer 

- empty 
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IXTransientAccess 


Adopted By: IXRecordManager 


Methods 

- (BOOL)getDoubleValue:(double *)aValue 

ofIvar:(const char *)ivarName 
forRecord:(unsigned int )aHandle 

- (BOOL)getFIoatValue:(float *)aValue 

ofIvar:(const char *)ivarName 
forRecord:(unsigned int )aHandle 

- (BOOL)getIntValue:(int *)aValue 

ofIvar:(const char *)ivarName 
forRecord: (unsigned int )aHandle 

- (BOOL)getObjectValue:(Object **)aValue 

offvar:(const char *)ivarName 
forRecord: (unsigned int )aHandle 

- (BOOL)getOpaqueValue:(NXData **)aValue 

ofIvar:(const char *)ivarName 
forRecord:(unsigned int )aHandle 

- (BOOL)getStringValue:(char **)aValue 

offvar:(const char *)ivarName 
forRecord:(unsigned int )aHandle 

- (BOOL)getStringValue:(char **)aValue 

inLength:(unsigned int )aLength 
offvar:(const char *)ivarName 
forRecord: (unsigned ini)aHandle 


Retrieves as a double the value of ivarName for the object 
whose record is identified by aHandle 

Retrieves as a float the value of ivarName for the object 
whose record is identified by aHandle 

Retrieves as a int the value of ivarName for the object 
whose record is identified by aHandle 

Retrieves as a object the value of ivarName for the object 
whose record is identified by aHandle 

Retrieves as untyped data the value of ivarName for the 
objectwhose record is identified by aHandle 

Retrieves as a string the value of ivarName for the object 
whose record is identified by aHandle 

Retrieves as a string no longer than aLength the value of 
ivarName for the object whose record is identified 
by aHandle 
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IXTransientMessaging 


Adopted By: IXRecordManager 


Methods 

- (BOOL)getDoubleValue:(double *)aValue 

ofMessage:(SEL )aSelector 
forRecord:(unsigned int )aHandle 

- (BOOL)getFloatYalue:(float *)aValue 

ofMessage:(SEL)aSe/ecfor 
forRecord: (unsigned int )aHandle 

- (BOOL)getIntValue:(int *)aValue 

ofMessage: (SEL )aS elector 
forRecord: (unsigned int )aHandle 

- (BOOL)getObjectValue:(Object **)aValue 

ofMessage:(SEL)a,SWecfor 
forRecord:(unsigned int )aHandle 

- (BOOL)getOpaqueValue: (NXData **)aValue 

ofMessage:(SEL)a5e/ector 
forRecord: (unsigned int )aHandle 

- (BOOL)getStringValue: (char **)aValue 

ofMessage:(SEL )aSelector 
forRecord:(unsigned int )aHandle 

- (BOOL)getStringValue:(char **)aValue 

inLength:(unsigned int )aLength 
ofMessage: (SE L)aSelector 
forRecord:(unsigned int )aHandle 


Retrieves as a double the value obtained by sending 
aSelector to the object whose record is identified 
by aHandle 

Retrieves as a float the value obtained by sending 
aSelector to the object whose record is identified 
by aHandle 

Retrieves as a int the value obtained by sending 
aSelector to the object whose record is identified 
by aHandle 

Retrieves as an object the value obtained by sending 
aSelector to the object whose record is identified 
by aHandle 

Retrieves as untyped data the value obtained by sending 
aSelector to the object whose record is identified 
by aHandle 

Retrieves as a string the value obtained by sending 
aSelector to the object whose record is identified 
by aHandle 

Retrieves as a string no longer than aLength the value 
obtained by sending aSelector to the object whose 
record is identified by aHandle 
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Functions 


Comparator Functions 


Compare two sets of data as arrays of various types and return their ordering. 

int IXCompareBytes(const void *datal, unsigned short lengthl, const void *data2, 

unsigned short length2 , const void * context) 

int IXCompareUnsignedBytes(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context ) 
int IXCompareShorts(const void *datal, unsigned short lengthl, const void *data2, 

unsigned short length2, const void * context ) 

int IXCompareUnsignedShorts(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context ) 
int IXCompareLongs(const void *datcil, unsigned short lengthl, const void *data2, 

unsigned short length2, const void * context ) 

int IXCompareUnsignedLongs(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context) 
int IXCompareFloats(const void *datal, unsigned short lengthl, const void *data2, 

unsigned short length2, const void * context ) 
int IXCompareDoubles(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context ) 
int IXCompareShort(const void * dotal, unsigned short lengthl, const void *data2, 

unsigned short length2, const void * context ) 

int IXCompareUnsignedShort(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context ) 
int IXCompareLong(const void *datal, unsigned short lengthl, const void *data2, 

unsigned short length2, const void * context ) 

int IXCompareUnsignedLong(const void "datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context ) 
int IXCompareFloat(const void *datal, unsigned short lengthl, const void *data2, 

unsigned short length2, const void * context ) 

int IXCompareDoubIe(const void *datal, unsigned short lengthl, const void *data2, 

unsigned short length2, const void * context ) 

int IXCompareStringAndUnsigneds(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context ) 
int IXCompareUnsignedAndStrings(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context ) 
int IXCompareStrings(const void *datal, unsigned short lengthl, const void *data2, 

unsigned short length2, const void * context) 

int IXCompareMonocaseStrings(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, const void * context) 
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Comparison Format Functions 


Compare two arrays of data based on a type encoding and return their ordering. 

int IXFormatComparator(const void *datal, unsigned short lengthl, 

const void *data2, unsigned short length2, void * format) 


IXBTree Locking Macros 


Lock and unlock an IXBTree for thread-safe access 

void IXLockBTreeMutex(/X57ree *aBTree ) 

void IXUnlockBTreeMutex(/X57ree *aBTree) 


IXStoreBlock Archiving Functions 


Archive or unarchive an object to or from an IXStore 

unsigned int IXWriteRootObjectToStore(IXStore *aStore, unsigned int aHandle, id anObject) 

id IXReadObjectFromStore(IXStore *aStore, unsigned int aHandle, 

NXZone *aZone) 


Functions 
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Types and Constants 


Defined Types 


IXComparator 

typedef int IXComparator 
(const void *datal, 
unsigned short lengthl, 
const void *data2, 
unsigned short length2, 
const void * context ); 

IXPosting 

typedef struct IXPosting { 
unsigned handle; 
unsigned weight; 

} IXPosting; 

IXStoreErrorType 

typedef enum IXStoreErrorType { 

IX_NoError = IX_STOREUSERERRORBASE, 
IX_InternalError, 

IX_ArgumentError, 

IX_QueryEvalError, 

IX_QueryTypeError, 

IX_QueryAttrError, 

IX_QueryImplError, 

IX_QueryYaccError, 

IX_MemoryError, 

IX_LockedError, 

IX_MacliineError, 

IX_VersionError, 

IX_DamagedError, 

IX_DuplicateError, 

IX_NotFoundError, 

IX_TooLargeError, 

IX_UnixErrorBase = IX_STOREUNIXERRBASE, 
IX_MachErrorBase = IX_STOREMACHERRBASE, 

} IXStoreErrorType; 
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Weighting Types 

typedef enum { 

IX_NoWeighting = 0, 
IX_Absolute Weighting, 
IX_FrequencyWeighting, 
IX_PeculiarityWeighting 
} IXWeightingType; 


Symbolic Constants 

IXStore Constants 

IX_ALLBLOCKS ((unsigned int)-lL) 

Indexing Kit Error Base Constants 

IX_STOREUSERERRBASE (9000) 

IX_STOREMACHERRBASE IX_STOREUSERERRBASE + (100) 

IX_STOREUNIXERRBASE IX.STOREUSERERRBASE + (300) 


Global Variables 

IXStore Pasteboard Type 

NXAtom IXStorePboardType; 

Indexing Pasteboard Types 

NXAtom IXAttributeReaderPboardType; 
NXAtom IXFileDescriptionPboardType; 


Types and Constants 7-33 



Query Language Symbols and Operators 


Literals 

self 

yes or true 
no or false 

"aString" or 'aString' 

number 

AttributeName 


Refers to the object the expression is being evaluated for 

Boolean values for TRUE 

Boolean values for FALSE 

Declares aString a string literal 

Any legal integer or floating point number 

An attribute reference 


Transform Operators 

quot e(some text ) 
regex(a BSD regular expression ) 
shell(an expression with shell wildcards) 
pars e(some text ) 


Results in a string value equal to some text 

Results in a regular expression 

Results in a regular expression 

Parses the text argument into an attribute-value list 


Projection Operators 

project {AttributeName entity_or_object) Projects the attribute named AttributeName from the set of 

attributes represented by entity_or_object 


Boolean Operators 

or(a b) 
and(« b) 

not(tf b) 
not(tf) 


Results in true if either a or b is true, false if both are false 

Results in true if both a and b are true, false if either is 
false 

Equivalent to and(a not(£)) 

The logical negation of a 


Set Operators 

or(.s t) 
or (j) 

andO t) 
andfs) 

not(.s t) 


Results in the union of sets s and t 

“Any one or more of the items in set j” (for use with search 
operators only) 

Results in the intersection of sets 5 and t 

“All of the items in set s” (for use with search operators 
only) 

Results in a set containing those items in set s that aren’t in 
set t 
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Relational Operators 


gt (a b) 

Results in true if a is greater than b, false otherwise 

ge(a b) 

Results in true if a is greater than or equal to b, false 
otherwise 

eq(a b) 

Results in true if a is equal to b, false otherwise 

ne(a b) 

Results in true if a is not equal to b, false otherwise 

lt(a b ) 

Results in true if a is less than b , false otherwise 

le(a b) 

Results in true if a is less than or equal b, false otherwise 

Arithmetic Operators 

add(a b) 

Results in the sum of a and b 

sub(a b) 

Results in difference of a and b 

mul(a b) 

Results in product of a and b 

div(a b) 

Results in quotient of a and b 

neg (a) 

Results in the arithmetic negative of a 

Search Operators 

whole(va/we) 

Searches for value as an exact match in the Default attribute 

wha\c(AttributeName value) 

Searches for value as an exact match in the attribute named 
AttributeName 

whole(entity value ) 

Searches for value as an exact match in entity; results in 
true if value is found, false if not 

whol e(string value ) 

Searches for value as an exact match to string; results in 
true if value is found, false if not (this is equivalent to 
eq (string value ) 

prefix() 

Searches for a value as a prefix match; arguments may be 
as for whole() 

within() 

Searches for a value as a match anywhere within an 
attribute or string; arguments may be as for wholeQ 

Pre-defined Attributes 

Default 

The default attribute defined by the query language 

Content 

For a file or file record, the literal text of the file 
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IXFileRecord Attributes 


FileName 

FileType 

FileDevice 

Filelnode 

FileMode 

FileCount 

FileOwner 

FileGroup 

FileSize 

AccessTime 

ModifyTime 

ChangeTime 

UnixType 


The name of a file relative to the root path of the 

IXFileFinder that created the IXFileRecord (string). 

The file’s type (string); for example, “rtf’. 

The device number for the device the file is on, as returned 
by stat() (number). 

The inode number of the file (number). 

The file’s permissions (number). 

The number of hard links to the file (number). 

The file’s owner (string). 

The file’s group (string). 

The file’s size, in bytes (number). 

The time the file was last accessed, as returned by stat() 
(number). 

The time the file’s content was last modified, as returned by 
stat() (number). 

The time the file’s status information was last changed, as 
returned by stat() (number). 

The inode type for the file, encoded as a number. 
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Attribute Reader Format 

Declaring Attributes 

{\zd AttributeName} 

{\zd AttributeName\ittypeEncoding } 

Marking Lexemes 

{\z lexeme } 

{\zrn} 

Adding Information to Lexeme Markings 

{\z lexeme\zsui } 

{\z lexeme\i\x weight} 

{\z lexeme\iccookie} 


Declare an attribute named AttributeName 

Declares the preceding attribute to be of type typeEncoding 


Mark lexeme as a lexeme associated with the Default 
attribute 

Short reference equivalent to the n th lexeme encountered 

Associate lexeme with the n th attribute declared 
Marks lexeme as though it occurred weight times in the text 
Declare cookie as an opaque identifier associated with 
the lexeme 
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Interface Builder 



Classes 


IBInspector 


Inherits From: Object 

Conforms To: IB Inspectors 

Accessing Objects 

- object Returns the object that’s being inspected 

- window Returns the window that contains the user interface for the 

inspector 


Managing Changes 

- t(mc\i:sender Changes the image in the Inspector panel’s close box to a 

broken “X” 

- textDidChange:se«Jer Sends the IBInspector a touch: message 
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IBPalette 


Inherits From: Object 

Associating Views and Objects 

- associateObjectianObjecl Establishes an association between aView and the object 

type:(NXAtom)/ype that should be instantiated when the user drags the 

with :aView aView from the palette. 

Initializing the Palette 

- finishlnstantiate Implement to complete the initialization of your IBPalette 

object 

Accessing Related Objects 

- paletteDocument Returns an object representing the dynamically loaded 

palette 

- originalWindow Returns the Window that contains the objects to be loaded 

into Palette window 

- findlmageNamed: (const char *)name Returns the NXImage instance associated with name 
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Object Additions 


Interface Builder declares these methods as additions to the Object class. 


Identifying Inspectors, Editors, and Images 

- (const char *)getConnectionInspectorClassName 

- (const char *)getEditorInspectorCIassName 

- (const char *)getHelpInspectorCIassName 

- (NXImage :|i )getIBImage 

- (const char *)getInspectorClassName 

- (const char *)getSizeInspectorClassName 


Implement to return class name of Connection inspector 
Implement to return class name of the object’s editor 
Implement to return class name of the Help inspector 

Implement to return an image to represent the object in the 
File window. 

Implement to return class name of the Attributes inspector 
Implement to return class name of the Size inspector 


View Additions 

Interface Builder declares these methods as additions to the Application Kit’s View class. 


Controlling Size 

- getMinSize:(NXSize *)minSize 

maxSize:(NXSize *)maxSize 
from:(int )where 

- place View: (NXRect *)frameRect 


Implement this method to control the dimensions of a View 


Notifies a View of a change in its frame size 


Classes: Object Additions 
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Protocols 


IB 

Adopted By: Interface Builder’s subclass of the Application class 

Accessing the Document 


- activeDocument 

Accessing the Selection Owner 

- selectionOwner 

Managing Connections 

- connectSource 

- connectDestination 

- (BOOL)isConnecting 

- stopConnecting 

- displayConnectionBetween:.s 0 M/re 

and '.destination 

Querying the Mode 

- (BOOL)isTestinglnterface 

Registering Controllers 

-registerDocumentControlIer:aContro//er 

- unregisterDocumentController: 


Returns the active document 


Returns the editor of the currently selected object 


Returns the object that’s the source of the connection 
Returns the object that’s the destination of the connection 
Returns YES if connection lines are being displayed 
Removes any connection lines from the screen 

Causes Interface Builder to draw connection lines between 
source and destination 


Returns YES if Interface Builder is in Test mode 


Adds aController to the list of objects to be notified when 
documents are opened or saved 

Removes aController from the list of document controllers 
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IBConnectors 


Adopted By: Connector objects 

Connector Methods 

- destination 

- establishConnection 

- free 

- niblnstantiate 

- read:(NXTypedStream *)stream 

- renewObject:oW 

to ’.new 

- source 

- write: (NXTypedStream *)stream 


Implement to return the object that’s the destination of the 
connection 

Implement to connect the source and destination objects 

Implement to release the storage for the connector object 

Implement to verify the identities of the connector’s source 
and destination objects 

Implement to unarchive the connector object from stream 

Implement to update a connector by replacing its old 
source or destination object with a new object 

Implement to return the object that’s the source of the 
connection 

Implement to archive the connector object to stream 


IBDocumenfs 

Adopted By: Interface Builder’s document 

Managing the Document 

- touch 

- getDocumentPathIn:(char *)buffer 

Managing the Object Hierarchy 

- attachObject: anObject 

to ’.parent 

- attachObjects:(List *)objectList 

to ".parent 

- deIeteObject:anC%ect 


objects 


Marks the document as edited 
Places the document’s path in buffer 


Adds anObject to the hierarchy by attaching it to parent 

Adds the objects in objectList to the hierarchy by attaching 
them to parent 

Removes anObject from the object hierarchy 
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- deleteObjects:(List *)objectList 

- copyObjecUanObject 

type:(NXAtom )type 

inPasteboard: (Pasteboard *)aPasteboard 

- copyObjects:(List *)objectList 

type:(NXAtom)(y/?e 

inPasteboard: (Pasteboard *)aPasteboard 

- (List *)pasteType:(NXAtom)ty/?e 

fromPasteboard :(Pasteboard *)pboard 
parent :the Parent 

- (BOOL)objectIsMember:an(96/ect 

- getObjects:(List *)objectList 

- getParentForObject '.anObject 

Setting Object Names 

- (BOOL)setName: (const char *)name 

ior'.anObject 

- getNameIn:(char *)name 

ior'.anObject 

Managing Connectors 

- addConnector taConnector 

- removeConnector :aConnector 

- listConnectors:(List *)aList 

iorSource'.aSource 

- listConnectors:(List *)aList 

iorDestinatiomaDestination 

- IistConnectors:(List *)aList 

iorSource'.aSource 
filter Class: filter Class 

- listConnectors:(List *)aList 

iorDestinationiaDestination 
filter Class: filter Class 

Managing Editors 

- setSelectionFrom:an£d/for 

- editorDidClose:an£c//tor 

ior:anObject 


Removes objects in objectList from the object hierarchy 
Copies anObject to the specified pasteboard 

Copies the objects in objectList to the specified pasteboard 


Alerts the document object that objects were pasted 

Returns YES if anObject is a part of the object hierarchy 
Places the objects from the object hierarchy into objectList 
Returns the object above anObject in the object hierarchy 


Sets the name associated with the anObject 

Places the name associated with anObject in the buffer 
name 


Adds a connector object to Interface Builder’s list 

Removes aConnector from the list of connectors. 

Places in aList connector objects whose sources 
are aSource 

Places in aList connector objects whose destinations 
are aDestination 

Places in aList the connector objects of class 
filterClass whose sources are aSource 

Places in aList the connector objects of class 
filterClass whose destinations are aDestination 


Registers anEditor as the editor that owns the selection 
Informs the document object that anEditor is no longer 
active 
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- getEditor:(BOOL)cr<?tffe/r Returns the editor object for anObject 

ior'.anObject 

- (BOOL)openEditorFor:flnO^‘ecr Opens the editor object for anObject 

Updating the Display 

- redrawObjectianObject Redraws the selected object by opening required editors 


IBDocumentControllers 

Adopted By: Document controller objects 

Notification Methods 

- didOpenDocument: r/ieDocumenr 

- didSaveDocument: theDocument 

- willSaveDocumenttr/zeDocnmenr 


Notifies the controller that theDocument has been opened 
Notifies the controller that theDocument has been saved 
Notifies the controller that the user is attempting to save 
theDocument 


IBEditors 

Adopted By: Editor objects in Interface Builder 

Initializing 

- initWith '.anObject Implement to initialize a newly allocated editor 

inDocument: aDocument 

Identifying Objects 

- document Implement this method to return the active document 

- editedObject Implement to return the object that’s being edited 

- window Implement to return the editor window 
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Displaying Objects 


- resetObject '.anObject 


Implement to redraw anObject 


Managing the Selection 

- (BOOL)wantsSelection Implement to return YES if the editor is willing to become 

the selection owner 

- selectObjects:(List *)objectList Implement to draw the objects in objectList as selected 

- makeSelectionVisible:(BOOL).s7i0w/r Implement to make the current selection visible 


Copying and Pasting Objects 

- (BOOL)copySelection Implement to copy the selected object(s) to the pasteboard 

- (BOOL)deleteSelection Implement to delete the selected object(s) 

- (BOOL)pastelnSelection Implement to paste object(s) from pasteboard into selection 

- (NXAtom)acceptsiypeFrom:(const NXAtom *)typeList 

Implement to return the pasteboard type your editor accepts 


Opening and Closing Editors 

- close 

- openSubeditorFor:an(9Z?/'ec? 

- closeSubeditors 


Implement to close the editor and free its resources 
Implement to open the subeditor for anObject 
Implement to close all subeditors 


Activating the Editor 

- orderFront 

- (BOOL)activate 


Implement to bring the editor’s window to the front 
Implement to activate the editor 


BBBnspectors 

Adopted By: IBInspector 

Required Inspector Methods 

- oik'.sender Implement in subclass to commit changes made in the 

Inspector panel 
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- revert '.sender Implement in subclass to load data into inspector’s display 

- (BOOL)wantsButtons Returns whether the inspector requires Interface Builder to 

display OK and Revert buttons in the Inspector panel 


IBObject 

(informal protocol) 

Adopted By: Custom palette objects 

Identifying Inspectors, Editors, and Images 

- (const char *)getConnectInspectorClassName 

- (const char *)getEditorClassName 

- (const char *)getHelpInspectorCIassName 

- (NXImage *)getIBImage 

- (const char *)getInspectorClassName 

- (const char *)getSizeInspectorClassName 


Returns the class name of the receiver’s connection 
inspector 

Returns the class name of the receiver’s editor 
Returns the class name of the receiver’s help inspector 

Returns the image that’s displayed in the File window when 
an instance of this class is created 
Returns the class name of the receiver’s attributes inspector 
Returns the class name of the receiver’s size inspector 


IBSelectionOwners 

Adopted By: Editor objects 

Selection Methods 

place the selected objects into objectList 
redraw the objects in the selection 
return the number of objects in the editor’s 


getSelectionInto:(List *)objectList 

redrawSelection 

(unsigned)selectionCount 


Implement to 
Implement to 

Implement to 
selection 
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Types and Constants 


Symbolic Constants 


Control Point Constants 

IB_BOTTOMLEFT 

IB_MIDDLELEFT 

IB_TOPLEFT 

IB_MIDDLETOP 

IB_TOPRIGHT 

IB_MIDDLERIGHT 

IB_BOTTOMRIGHT 

IB_MIDDLEBOTTOM 


Global Variables 


Pasteboard Types 

NXAtom IBObjectPboardType; 
NXAtom IBCellPboardType; 
NXAtom IBMenuPboardTvpe; 
NXAtom IBMenuCellPboardType; 
NXAtom IBViewPboardType; 
NXAtom IBWindowPboardType; 
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Mach Kit 


Classes 


IMXConditionLock 


Inherits From: Object 


Conforms To: NXLock 


Initializing an Instance 


-init 

Initialize a condition lock 

- iniCWith:(int)condition 

Initialize and set condition 

Get the Condition of the Lock 


- condition 

Return the condition 

Acquire or Release the Lock 


- lock 

Grab the lock 

- lockWhen:(int)con<i/rion 

Wait for the condition 

- unlock 

Release the lock 

- unlockWith:(int)conc?iYion 

Release and set the condition 
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INJXData 


Inherits From: Object 

Conforms To: NXTransport 

Transporting Data 

- encodeRemotelyFor: Has the data copied across a connection 

(NXConnection *) connection 
freeAfterEncoding:(BOOL *)flagp 
isBy copy: (BOOL) is By copy 

- encodeUsing:(id <NXEncoding>)porta/ Encodes the data across a connection 

- decodeUsing: (id <NXDecoding>)/?orta/ Encodes the data across a connection 

Initializing and Freeing Instances 

- initWithSize: (unsigned int) size 

- initWithData:(void *)data 

size: (unsigned) size 
dealloc:(BO OL) flag 

- free 

Getting the Object's Data 

- data Returns the data 


Allocates memory for data 
Wraps preexisting data 

Frees the object 


Getting the Data's Size 

- size 


Returns the size of the data 


Copying the Object 

- copyFromZone:(NXZone *)zone 


Copies the object 
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NXInvalidationNotifier 


Inherits From: Object 

Conforms To: NXReference 


Counting References 

- addReference 

- free 

- references 

Initializing a New Object 

- init 

Really Freeing an Object 

- deallocate 

Getting and Setting Validity 

- invalidate 

- isValid 

Invalidation Notification 

- registerForlnvalidationNotification: 

(id <NXSenderIsInvalid>)a«0ib/ect 

- unregisterForlnvalidationNotification: 

(id <NXSenderIsInvalid>)a«OZy'ect 


Adds a reference 

Removes a reference, but doesn’t free object 
Returns number of references 


Initializes an instance 


Frees an instance 


Marks the object as invalid 
Returns whether object is valid 

Ensures object will be notified when receiver dies 
Removes object for notification list 
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NXLock 


Inherits From: Object 

Conforms To: NXLock 

Grab the lock 
Release the lock 


Acquire or Release a Lock 

- lock 

- unlock 


NXNetNameServer 

Inherits From: Object 


Making a Port Available 

+ checkInPort:(NXPort *)nxport Advertises a port 

withName:(const char *)aName 


Removing a Port 

+ checkOutPortWithName: Withdraws a port from public display 

(const char *)name 

Getting Ports 

+ (NXPort *) lookUpPortWithName: Finds a port on the local host 

(const char *)name 

+ (NXPort *) lookUpPortWithName: Finds a port on a named host 

(const char *)name 
onHost:(const char *)hostname 
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NXPort 


Inherits From: NXInvalidationNotifier: Object 

Conforms To: NXReference (NXInvalidationNotifier) 

NXTransport 


Transporting Ports 

- encodeRemotelyFor: Has the port copied across a connection 

(NXConnection *)connection 
freeAfterEncoding:(BOOL *)flagp 
isBy copy: (BOOL) is By copy 

- encodeUsing:(id <NXEncoding>)porta/ Encodes the port across a connection 

- decodeUsing:(id <NXDecoding>)porta/ Encodes the port across a connection 


Creating an NXPort 

+ new 

+ newFromMachPort:(port_t) p 

+ newFromMachPort:(port_t) p 
dealloc:(BOOL) flag 

Freeing an NXPort 

- free 

Listening for Port Deaths 

+ worry AboutPortlnvalidation 

Identifying the Mach Port 

- machPort 

- hash 


Creates a new NXPort object 
Wraps an existing port 
Wraps an existing port 


Frees an NXPort object 


Forks a thread to listen for port deaths 


Returns the embedded mach port 
Returns a hashtable value for the object 


C/asses: NXPort 
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NXProtocolChecker 


Inherits From: Object 

Initializing a Protocol Checker 

- initWithObject:anC%ect 

forProtocol:(Protocol *)proto 

Reimplemented Object Methods 

- forward:(SEL)sel:(void *)args 

- (struct objc_method_description *) 

descriptionForMethod:(SEL)s<?/ 

- free 


Initializes a new object 

Passes allowed messages to its delegate 

Required for the run-time system 
Frees the checker and/or its delegate 


IMXRecursiveLock 

Inherits From: Object 

Conforms To: NXLock 

Acquire or Release a Lock 

- lock 

- unlock 


Grab the lock 
Release the lock 
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NXSpinLock 


Inherits From: Object 

Conforms To: NXLock 

Acquire or Release a Lock 

- lock Grab the lock 

- unlock Release the lock 


Classes: NXSpinLock 9-7 



Protocols 


NXLock 

Adopted By: 

Declared In: 

Mandatory methods 

- lock 

- unlock 


IMXReference 

Adopted By: 

Declared In: 

Mandatory methods 

- addReference 

- free 

- references 


NXConditionLock 

NXLock 

NXSpinLock 

NXRecursiveLock 

machkit/NXLock.h 


Acquires the lock 
Releases the lock 


IXFileFinder 

IXStoreBlock 

NXConnection 

NXInvalidationNotifier 

NXProxy 

machkit/reference .h 


Adds a reference 

Removes a reference, possibly freeing object 
Returns number of references 
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NXSenderlsInvalid 


Adopted By: 


.. Declared In: 


NXConnection 

NXDataLinkManager 

machkit/senderlslnvalid.h 


Mandatory methods 

- senderlslnvalidisender 


Sent when sender becomes dysfunctional 
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Types and Constants 


Defined Types 


NXMachKitException 

typedef enum { 

nx_mach_kit_exception_base = 10000, 

NX_portInvalidException = 10001, 
NX_restrictionEnforcedException =10010, 
NX_referenceAlreadyFreeException = 10020, 
NX_MACH_KIT_LAST_EXCEPTION = 10999 
} NXMachKitException 


9-10 Chapter 9: Mach Kit 



MIDI Driver API 


Driver Functions 


Clock Functions 


Functions to set clock behavior: 

kem_retum_t MIDISetClockMode(port_t driverPort, port_t ownerPort, short synchUnit, 

int mode ) 

kem_retum_t MBDISetClockQuantum(port_t driverPort, port_t ownerPort, int interval) 

Functions to set and get clock time: 

kem_retum_t MIDISetClockTime(port_t driverPort, port_t ownerPort, int time ) 

kem_retum_t MIDIGetClockTime(port_t driverPort, port_t ownerPort, int *time) 
kem_retum_t MIDIGetMTCTime(port_t driverPort, port_t ownerPort, short * 'format , 

short *hours, short *minutes, short * seconds , short *frames) 


Functions to start and stop the clock: 

kem_retum_t MIDIStartCIock(port_t driverPort, port_t ownerPort ) 

kem_retum_t MIDIStopClock(port_t driverPort, port_t ownerPort) 
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Data Sending Function 


Send data via the MIDI driver: 

kern_retum_t MIDISendData(port_t driverPort, port_t ownerPort, short unit, 

MIDIRawEvent *data, unsigned int count ) 


Driver Ownership Functions 

Acquire and release ownership of the MIDI driver: 

kem_return_t MIDIBecomeOwner(port_t driverPort, port_t ownerPort) 
kem_retum_t MIDIReleaseOwnership(port_t driverPort, port_t ownerPort ) 


Ignore MIDI Codes Function 

Request that the driver ignore certain MIDI codes: 

kern_retum_t MIDISetSystemIgnores(port_t driverPort, port_t ownerPort, short unit, 

unsigned int ignoreBits ) 


Queue Management Functions 

Query about and manage data flow in the queue: 

kem_return_t MIDIClearQueue(port_t driverPort, port_t ownerPort, short unit ) 
kem_return_t MIDIFlushQueue(port_t device_port, port_name_t ownerPortjport, short unit ) 

kem_retum_t MIDIGetAvailableQueueSize(port_t driverPort, port_t ownerPort, short unit, 

int *theSize ) 
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Reply Handling Functions 


Handle replies from the MIDI driver to a client: 

kem_retum_t MIDIAwaitReply(port_t reply_port, MIDIReplyFunctions * handlers, int timeout) 

kem_retum_t MIDIHandleReply(msg_header_t *msg, MIDIReplyFunctions * handlers) 


Request Functions 


Request services from the MIDI driver: 


kern_return_t 

kern_retum_t 

kern_retum_t 

kem_retum_t 


MIDIRequestData(port_t driverPort, port_t ownerPort, short unit, 
port_t replyPort) 

MIDIRequestAlarm(port_t driverPort, port_t ownerPort, port_t replyPort, 
int time ) 

MIDIRequestExceptions(port_t driverPort, port_t ownerPort, port_t replyPort) 

MIDIRequestQueueNotification(port_t driverPort, port_t ownerPort, short unit, 
port_t replyPort, int size) 


Serial Port Ownership Functions 


Acquire and release ownership of the serial ports: 

kem_retum_t MIDIClaimUnit(port_t driverPort, port_t ownerPort, short unit) 
kem_retum_t MIDIReleaseUnit(port_t driverPort, port_t ownerPort, short unit) 
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Types and Constants 


Defined Types 


MIDIAIarmReplyFunction 

typedef void (*MIDIAlarmReplyFunction)(port_t reply Port, int requestedTime, 
int actualTime) 

MIDIDataReplyFunction 

typedef void (*MIDIDataReplyFimction)(port_t replyPort, short unit, MIDIRawEvent * events, 
unsigned int count) 

MIDlExceptionReplyFunction 

typedef void (*MIDIExceptionRepIyFunction)(port_t replyPort, int exception) 

MIDIQueueReplyFunction 

typedef void (*MIDIQueueRepIyFunction)(port_t replyPort, short unit) 

MIDIRawEvent 

typedef struct { 
int time; 

unsigned char byte; 

} MIDIRawEvent 

MIDIReplyFunctions 

typedef struct _MIDIReplyFunctions { 

MIDIDataReplyFunction dataRepIy; 

MIDIAIarmReplyFunction alarmRepIy; 

MIDlExceptionReplyFunction exceptionRepIy; 

MIDIQueueReplyFunction queueReply; 

} MIDIReplyFunctions; 
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Symbolic Constants 


Clock Modes 

MIDI_CLOCK_MODE_INTERNAL 

MIDI_CLOCK_MODE_MTC_SYNC 


Controller Definitions 

MIDI_EXTERNALEFFECTSDEPTH 

MIDI_TREMELODEPTH 

MIDI_CHORUSDEPTH 

MIDI_DETUNEDEPTH 

MIDI_PHASERDEPTH 

(from original 1.0 MIDI spec) 

MIDL.EFFECTS1 

MIDI_EFFECTS2 

MIDI_EFFECTS3 

MIDI_EFFECTS4 

MIDI_EFFECTS5 

MIDI_DATAINCREMENT 

MIDI_DATADECREMENT 

(From June 1990 spec) 


Error Codes 

MIDI_ERROR_BUSY 

midi_error_not_owner 

midi_error_queue_full 

midi_error_bad_mode 

MIDI_ERROR_UNIT_UNAVAILABLE 
MIDI_ERROR_ILLEGAL_OPERATION 
MIDI_ERROR_UNKN OWN_ERROR 


Event Count 

Value 

MIDI_MAX_EVENT 

100 

Event Size 

Value 

MIDI_MAX_MSG_SIZE 

1024 
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Exception Codes 


MIDI_EXCEPTION_MTC_STOPPED 

MIDI_EXCEPTION_MTC_STARTED_FORWARD 

MIDI_EXCEPTION_MTC_STARTED_REVERSE 


General MIDI Constants 

MIDI_RESETCONTROLLERS 

MIDI.LOCALCONTROL 

MIDI_ALLNOTESOFF 

MIDI_OMNIOFF 

MIDI_OMNION 

MIDI_MONO 

MIDI_POLY 

MIDI_NOTEOFF 

MIDI_NOTEON 

MIDI_POLYPRES 

MIDI_CONTROL 

MIDI_PROGRAM 

MIDI_CHANPRES 

MIDLPITCH 

MIDLCHANMODE 

MIDI_CONTROL 

MIDI_SYSTEM 

MIDI_SYSEXCL 

MIDI_TIMECODEQUARTER 

MIDI_SONGPOS 

MIDI_SONGSEL 

MIDI_TUNEREQ 

MIDI_EOX 

MIDLCLOCK 

MIDI_START 

MIDI_CONTINUE 

MIDI_STOP 

MIDLACTIVE 

MIDI.RESET 

MIDI_MAXDATA 

MIDI_MAXCHAN 

MIDI_NUMCH AN S 

MIDI_NUMKEYS 

MIDI_ZEROBEND 

MIDI_DEFAULTVELOCITY 
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Ignores 


MIDI_IGNORE_CLOCK 

MIDI_IGNORE_START 

MIDI_IGNORE_CONTINUE 

MIDI_IGNORE_STOP 

MIDI_IGNORE_ACTIVE 

MIDI_IGNORE_RESET 

MIDI_IGNORE_RE AL_TIME 


Least Significant Bit for Controller Numbers 

MIDI_MODWHEELLSB 

midi_breathlsb 

MIDI_FOOTLSB 

MIDI_PORTAMENTOTIMELSB 

MIDI_DATAENTRYLSB 

MIDI_MAINVOLUMELSB 

midi_balancelsb 

MIDIJPANLSB 

MIDI_EXPRESSIONLSB 

MIDI_DAMPER 

MIDI_PORTAMENTO 

MIDI_S O STENUTO 

MIDI_SOFTPEDAL 

MIDI_HOLD2 


Masks for MIDI Status Bytes 

MIDLSTATUSBIT 
MIDI_STATUSMASK 
MIDI_S Y SRTBIT 


Miscellaneous 

MIDI_NO_TIMEOUT 
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MIDI Controller Numbers 


MIDI_MODWHEEL 

MIDI_BREATH 

MIDI_FOOT 

MIDI_PORTAMENTOTIME 

MIDI_DATAENTRY 

MIDI_MAINVOLUME 

MIDI_BALANCE 

MIDI_PAN 

MIDI_EXPRESSION 

MIDI_EFFECTCONTROL 1 

MIDI_EFFECTCONTROL2 


Port Constants 

MIDI_PORT_A_UNIT 

MIDI_PORT_B_UNIT 
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Classes 


NIDomain 


Inherits From: Object 

Allocating and Initializing an NIDomain Object 
+ alloc 

+ allocFromZone:(NXZone *)zone 

- init 

Freeing an NIDomain Object 

-free 

Making or Freeing a Connection to a Domain 

- (ni_status)setConnection:(const char *)domain 

- (ni_status)setConnection:(const char *)domain 

readTimeout:(int)rtime 
writeTimeout: (int)wfime 
canAbort:(BOOL)a6o7t 
mustWrite:(BOOL )write 


Allocates an NIDomain object 

Allocates an NIDomain object from the specified zone 

Initializes a new NIDomain object 


Deallocates an NIDomain object 


Makes a connection to a domain 

Makes a connection to a domain, as specified 
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- (ni_status)setTaggedConnection:(const char *)tag 

to:(char *)hostName 

- (ni_status)setTaggedConnection: (const char *)tag 

to:(char *)hostName 
readTinieout:(int)rr/m<? 
writeTimeout: (int )wtime 
canAbort:(BOOL)aZ?orr 

- disconnectFromCurrent 

Getting Data about or from the Current Domain 

- (const char *)getFuHPath 

- (const char *)getMasterServer 

- (const char *)getCurrentServer 

- (const char *)getTag 

- (const struct sockaddrjn *)getServerIPAddress 

- (void *)getDomainHandle 

- (ni_entrylist *)findDirectory:(const char *)parentD 

withProperty: (const char *) property 


Makes a connection to a domain, using host name and tag 
Makes a connection to a domain, as specified 


Terminates a connection to a domain 


Gets the path name of the current domain 
Gets the host name of the current domain’s master server 
Gets the host name of the current domain’s current server 
Gets the tag of the current domain 

Gets the socket address of the current domain’s current 
server 

Gets the Netlnfo™ handle of the current domain 
rectory 

Gets the values associated with a property 


Checking the Error Status 

- (ni_status)lastError Returns the status code from the most recent Netlnfo call 

Assigning a Delegate 

- setDelegateranOZy'ect Sets the delegate of the NIDomain object 


NIDomainPanel 

Inherits From: Object 

Allocating and Initializing an NIDomainPanel Object 

+ new Returns an NIDomainPanel object 

+ allocWithoutPanelFromZone:(NXZone *)zone Allocates an NIDomainPanel object that has no panel 
- init Initializes a new NIDomainPanel object 
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Displaying the Panel 

- (mt)runModal Brings up the panel 

- resizePanelBeforeShowing:(const char *)panelDefaultName 

Resizes the panel 

- panel Returns the id of the panel 

- windowDidResize: sender Detects that the window has changed size 

Getting Data 

- (int)exitFlags 

- (const char *)domain 

- (const char *)panelSizeDefaultName 

Filling the Browser 

- loadDomainBrowser Loads current domain information into the browser 

- loadDomainBrowserFrom:(const char *)whereFrom 

Loads information from the domain into the browser 

- (int)browser:sender Fills the indicated column with data 

fillMatrix :ma trix 
inColumn: (int )column 

- browser '.sender Fills the indicated cell with data 

loadCell: cell 
atRow: (int) row 
inColumn :(int)co/wmn 

- freeLastColumn Clears the data in the rightmost column of the browser 

- fillNextColumn Fills the next column of the browser 

Text-Related Methods 

- completeDomain 

- rnnOk'.sender 

- texUtextObject 

isEmpty:(BOOL )flag 

- textWillChang eitextObject 

- (BOOL)textWillEnd itextObject 

Target and Action Methods 

- ceIlWasHitInBrowser:(id)sender 

- canc ehsender 

- ok:sender 
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Method invoked by the browser 
Method invoked by the Cancel button 
Method invoked by the OK button 


Completes the text in the text field 
Calls the OK button’s action method 
Detects empty text field 

Detects that text is about to change 

Detects that the user has finished editing the text field 


Returns the exit flags from the panel 
Returns the name of the selected domain 
Returns a string indicating the panel’s default size 



NILoginPanel 


Inherits From: Panel: Window : Responder : Object 


Creating a Panel 

+ new 


Returns an NILoginPanel object 


Running the Panel 

- (BOOL)runModaI:sen^er Brings up the panel 

inDomain:(void *)domainID 

- (BOOL)runModaI:se«fifer Brings up the panel, as specified 

inDomain:(void *)domainID 
withUser: (const char *)userName 
withInstruction:(const char *)whatWaming 
alio wChange: (B OOL) disable User 

- (BOOL)runModalWithVaIidation:sender Brings up the panel and specifies validation by the delegate 

inDomain:(void *)domainID 
withUser:(const char *)userName 
withlnstruction:(const char *)whatWarning 
al\owChange:(BOOL)enableUser 

Target and Action Methods 

- ok ‘.sender Method invoked by the OK button 

- cancel '.sender Method invoked by the Cancel button 


Getting Data 

- (BOOL)isValidLogin:^nder 

- (const char *)getPassword:sender 

- (const char *)getUser ’.sender 


Returns whether the login was successful 
Returns the text in the password field 
Returns the text in the account name field 
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NIOpenPanel 


Inherits From: NIDomainPanel : Object 

Initializing and Running a Panel 

+ new 

- (int)runModal 

Getting Data from the Panel 

- (const char *)directory 

- (const char *)panelSizeDefaultName 

Manipulating the Panel 

- setDirectoryPath:(const char *)path 

- setListTitle: (const char *)title 

- setPanelTitle: (const char *)title 

- refreshLowerData:.se/z^r 

Searching 

- searchItemIJst:tocf77zmg 

- searchTextField 

Filling the Browser 

- (int)browser:.sender 

fiUMatrix: matrix 
inColumn: (int )colutnn 

- browser '.sender 

loadCel Y.cell 
atRow:(int)row 
inColumn:(int )column 

Text-Related Methods 

- text itextObj 

isEmpty: (B O OL )flag 

- (BOOL)textWillChange: textObject 


Returns an NIOpenPanel object 
Brings up the panel 


Returns the directory that’s selected in the lower browser 
Returns a string indicating the panel’s default size 


Sets the initial directory path in the lower browser 
Sets the title of the lower half of the panel 
Sets the title of the panel 
Rereads and redraws the lower browser 


Keeps lower browser and text field in sync 
Keeps lower browser and text field in sync 


Fills the indicated column with data 

Fills the indicated cell with data 


Detects empty text field 
Detects that text is about to change 
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- completeltemName 

- completeDomain 

Target and Action Methods 

- cellWasHitInBrowser:(id)sen</er 

- cellWasHitlnltemListrsender 


Reserved for future use 

Completes the text in the upper text field 


Method invoked by the upper browser 
Method invoked by the lower browser 


IMISavePanel 


Inherits From: NIOpenPanel: NIDomainPanel: Object 

Creating a New NISavePanel Object 

+ new Returns an NISavePanel object 

Displaying the Panel 

- (int)runModal Brings up the panel 

- (int)runModalWithString:(char *)initialValue Brings up the panel, with the string in the lower text field 

- (int)runModalWithUneditableString:(char *)initialValue 

Brings up the panel, with an uneditable string in the lower 
text field 


Getting Data from the Pane! 

- (const char *)panelSizeDefaultName 

- (const char *)directory 

Target and Action Methods 

- cellWasHitInItemList:.sender 

Manipulating the Panel 

- setStartingDomainPath:(const char *)directory 

- refreshLowerData render 


Returns a string indicating the panel’s default size 
Returns the directory that’s selected in the lower browser 


Method invoked by the lower browser 


Sets the initial path in the upper browser 
Rereads and redraws the lower browser 
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Functions 


This section summarizes the single Netlnfo Kit function. 

Fill a column of a domain structure: 

ni_status NIFillDomamHierarchy(struct NIHierarchyOfDomains * domains, int level , const 

char *toMatch , int selectedLevel ); 
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Types and Constants 


Symbolic Constants 


Connection Status 

NI_ALRE ADY CONNECTED 
NI_NOTCONNECTED 


Test Mode Value 

NIJJSERTESTMODE 0 

NI_NETINFOTESTMODE 1 


Structures 


NIDomainCellData 

struct NIDomainCellData { 
char *name; 

BOOL isaLeaf; 

} 

NIHierarchyOfDomains 

stnict NIHierarchyOfDomains { 
int numberOfLevels; 

struct NIMultiDomainList *domainListAtLevel; 

} 

NIMultiDomainList 

struct NIMultiDomainList { 
int numberOfDomains; 
int activeDomain; 
id activeDomainObject; 
struct NIDomainCellData *topDomain; 

} 
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Networks: Novell NetWare 


Please contact Novell, Inc. for documentation on the Novell® NetWare® 
programming interface. 
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Phone Kit 


Classes 


NXPhone 


Inherits From: Object 

Initializing an NXPhone Object 

-init Initializes the NXPhone object to be type NX_ISDNDevice 

- initType:(NXPhoneDeviceType)<iev/ce7>7J6 Initializes the NXPhone object to deviceType 

Running the Connection to the Phone Server 
-run 

- runFromAppKit 

- addPort:(port_t)aPort 

receiver :anObject 
method:(SEL )aSelector 

Testing the Phone Line 

- (BOOL)isActive Returns whether the phone line is working 


Runs the connection to the Phone Server 

Makes the main event loop monitor the Phone Server 

Adds aPort as a source for remote input 
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Managing Channels 


- (yoid)addChanne\:aChannel 

- (void)removeChannel '.aChannel 

- (BOOL)acquireChannel '.aChannel 

- (voidjreleaseChannekaC/zanne/ 


Registers aChannel as one that the application can use 
Disassociates aChannel from the NXPhone object 
Locks down aChannel for the application’s exclusive use 
Relinquishes exclusive rights over aChannel 


NXPhoneCall 


Inherits From: Object 

Initializing an NXPhoneCall Object 
-init 

- initType: (NXPhoneCallType)ca//Type 

- (void)setType: (NXPhoneCallTy pe)callType 

- (NXPhoneCallType)type 

Initiating a Call 

- (void)pickUp 

- (void)dialToneReceived 

- (void)dialDigits:(char *)digits 

- (void)dialingCompIete 

- (void)remoteBusy 

- (void)remoteRing 

- (void)remotePickup 

Getting a Call 

- (void)ring 

- (void)pickUp 


Initializes the NXPhoneCall to be type NX_VoiceCall 
Initializes the NXPhoneCall object to callType 
Sets the NXPhoneCall object to be callType 
Returns the call type, NX_VoiceCall or NX_DataCall 


Takes the phone off-hook to initiate an outgoing call 
Implemented by subclasses to respond to a dial tone 
Dials the phone number recorded in digits 
Implemented by subclasses to react when number is dialed 
Implemented by subclasses to respond to busy signal 
Implemented by subclasses to respond to remote ring 
Implemented by subclasses to respond to remote pickup 


Implemented by subclasses to respond to ringing phone 
Takes the phone off-hook to answer an incoming call 
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Sending and Receiving Data 

- (void)callConnected Implemented by subclasses to respond when call is set up 

- (void)transmitData:(void *)data Implemented by subclasses to transmit data during a call 

length: (int)« umfiy tes 

- (void)dataReceived:(void *)data Implemented by subclasses to accept data during a call 

length: (int) numBytes 

- (void)useHDLC:(BOOL)/7ag Determines whether transmitted data is HDLC encoded 

Putting a Call on Hold 

- (void)hold 

- (void)resume 

Detecting a Touch-Tone 

- (void)toneReceived:(int)£ey Implemented by subclasses to respond to a remote tone 

Terminating a Call 

- (void)hangUp 

- (void)remoteHangup 

- (void)callReleased 

Finding the Current State of the Call 

- (NXPhoneCallState)state Returns the current status of the phone call 

Responding to Errors 

- (yoid)error:(SEL)lastMessage Implemented by subclasses to respond to error notifications 

reason: (NXPhoneError)caw.s'e 


Puts the phone back on-hook and terminates the call 
Implemented by subclasses to respond to a remote hangup 
Implemented by subclasses to respond when call is ended 


Not implemented for Release 3 
Not implemented for Release 3 
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INIXPhoneChannel 


Inherits From: Object 

Initializing an NXPhoneChannel Object 

- init Initializes the NXPhoneChannel to NX_AnyISDNChannel 

- initType:(NXPhoneChannelType)c/2awie/7y/?<? Initializes the NXPhoneChannel object to channelType 

- (void)setType:(NXPhoneChannelType)c/zanne/7ype 

Sets the type of the NXPhoneChannel to channelType 

- (NXPhoneChannelType)type Returns the channel type 

Tracking Calls 

- (void)addCall:aC<z// 

- (void)removeCaIl:aCa// 

- activeCall 

Setting Up an Incoming Call 

- allocateIncomingCallOfType:(NXPhoneCallType)ca//7y/7e 

Implemented by subclasses to provide object to handle call 

- (BOOL)acceptCall mewCall Implemented by subclasses to accept or refuse a call 

Responding to Errors 

- (void)channelError:(NXPhoneError)caws , e Implemented by subclasses to handle errors due to cause 


Adds aCall to the channel 
Removes aCall from the channel 

Returns the currently active NXPhoneCall for the channel 
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Functions 


Error Function 

Get a string matching an error constant: 

const char *NXPhoneErrorString(NXPhoneError errval) 
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Types and Constants 


Defined Types 


NXPhoneCallState 

typedef enum { 

NX_PhoneNullState = -1, 

NX_PhoneIdle = 0, 

NX_PhoneOriginating = 1, 

NX_PhoneDialing = 2, 

NX_PhoneConversation = 3, 

NX_PhoneAIerting = 4, 

NX_PhoneReleasing = 5 
} NXPhoneCallState; 

NXPhoneCallType 

typedef enum { 

NX_DataCall = 4, 

NX_VoiceCall = 5 
} NXPhoneCallType; 

NXPhoneChannelType 

typedef enum { 

NX_BlChannel, 

NX_B2Channel, 

NX_DChannel, Not implemented forRelease 3 

NX_POTSChannel, 

NX_AnyISDNChannel 
} NXPhoneChannelType; 

NXPhoneDeviceType 

typedef enum { 

NX_ISDNDevice, 

NX_POTSDevice 
} NXPhoneDeviceType; 
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NXPhoneError 

typedef enum { 

NXJNfotEndToEndlSDN, 
NX_BufferOverflow, 
NX_TransmitFailure, 
NX_NoHardwareAttached, 
NX_HardwareFailure, 
NX_TemporaryNetworkFailure, 
NX_FacilityNotSubscribed 
} NXPhoneError; 
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U & Preferences 


Classes 


Application Additions 

Preference implements these methods as additions to the Application class of the Application Kit. 

Loading the Interface 

- loadNibForLayout: (const char *)name 

owner xanOwner 

Controlling Menu Items 

- enableEdit:(int)aMa.s'fc 

- enableWindow: 

Accessing the Preferences Window 

- appWindow Returns the id of the Preferences window 


Enables and disables menu items in the Edit menu 
Enables and disables menu items in the Window menu 


Loads the nib file named “name.nib” and makes anOwner 
its owner 
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Layout 


Inherits From: Object 

Accessing the Root View 

- view Returns the View that’s loaded into the Preferences window 


Notification of State Change 


- didHid ^.sender 

Received 

- didUnhide render 

Received 

- willSelectrsencfer 

Received 

- didSelect:se« der 

Received 

- wiIlUnselect:se«fifer 

Received 

- didUnselect: sender 

Received 


when the application hides itself 

when the application unhides itself 

before the module is displayed 

after the module is displayed 

before the module is removed from display 

after the module has been removed from display 
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Types and Constants 


Symbolic Constants 


Window Menu Constants 

MINIATURIZEJTEM 

CLOSE_ITEM 

WINDOW_ALL_ITEMS 


Edit Menu Constants 

CUTJTEM 

COPY_ITEM 

PASTEJTEM 

SELECTALL.ITEM 

EDIT_ALL_ITEMS 
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The Run-Time System 


Classes 


Protocol 


Inherits From: Object 

Getting the Protocol Name 

- (const char *)name Returns the name of the protocol 

Testing for Incorporated Protocols 

— (BOOL)conformsTo:(Protocol *)aProtocol Returns whether the receiver incorporates aProtocol 


Getting Method Descriptions 

- (struct objc_method_description *)descriptionForInstanceMethod:(SEL)fl5’e/e , ctor 

Returns information about the aSelector instance method 

- (struct objc_method_description *)descriptionForCIassMethod:(SEL)aSWecrc>r 

Returns information about the aSelector class method 


Classes: Protocol 15-1 





Functions 


Class Functions 


Create a new instance of a class: 

id class_createInstance(Class aClass, unsigned int indexedlvarBytes ) 

id cIass_createInstanceFromZone(Class aClass, unsigned int indexedlvarBytes, 

NXZone *zone) 

Get the class template for an instance variable: 

Ivar class_getInstanceVariabIe(Class aClass, const char *variableName) 


Get, add, and remove methods: 

Method class_getInstanceMethod(Class aClass, SEL aSelector) 

Method class_getClassMethod(Class aClass, SEL aSelector ) 

void class_addMethods(Class aClass, struct objc_method_list *methodList) 

void cIass_removeMethods(Class aClass, struct objc_method_list *methodList) 

Pose as the superclass: 

Class class_poseAs(Class thelmposter. Class theSuperclass ) 


Set and get the class version: 

void classjsetVersion(Class aClass, int versionNumber) 

int class_getVersion(Class aClass) 
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System Functions 


Manage run-time structures: 


id 

objc_getClass(const char *aClassName) 

id 

objc_lookUpClass(const char *aClassName ) 

id 

objc_getMetaClass(const char *aClassName) 

NXHashTable * 

°bjc_g e tClasses(void) 

void 

objc_addClass(Class aClass ) 

Module * 

°bjc_getM°dules(void) 


Dynamically load and unload classes: 

long objc_IoadModules(char *files[\, NXStream * stream, 

void (*callback)( Class, Category), struct mach_header **header, 
char * debug Filename) 

long objc_unloadModules(NXStream * stream, void (*callback)(C lass, Category)) 

Send messages at run time: 

id objc_msgSend(id theReceiver, SEL theSelector ,...) 

id objc_msgSendSuper(struct objc_super *superContext, SEL theSelector ,...) 

id objc_msgSendv(id theReceiver, SEL theSelector, unsigned int argSize, 

marg_list argFrame ) 

Make the run-time system thread safe: 

void objc_setMultithreaded(BOOL/?ag) 
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Object Functions 


Manage object memory: 

id object_dispose(Object *anObject ) 

id object_copy(Object *ariObject, unsigned int indexedlvarBytes ) 

id object_copyFromZone(Object *anObject, unsigned int indexedlvarBytes, 

NXZone *zone) 

id object_reaIloc(Object *anObject, unsigned int numBytes) 

id object_realIocFromeZone(Object *anObject, unsigned int numBytes, 

NXZone *zone) 


Return the class name: 

const char * object_getClassName(id anObject ) 

Set and get instance variables: 

Ivar object_setInstanceVariable(id anObject, const char *variableName, void *value) 

Ivar object_getInstanceVariabIe(id anObject, const char *variableName, void **value) 

Return a pointer to an object's extra memory: 

void * object_get!ndexedIvars(id anObject ) 


Method Functions and Macros 


Get information about a method: 


unsigned int 
unsigned int 
unsigned int 


method_getNumberOfArguments(Method aMethod) 
method_getSizeOfArguments(Method aMethod) 

method_getArgumentInfo(Method aMethod, int index, const char **type, 
int * offset ) 


Examine and alter method argument values: 


type-name 
type-name * 
void 


marg_getYalue(marg_list argFrame, int offset , type-name ) 
marg_getRcf(marg_list argFrame, int offset, type-name) 
marg_setVaIue(marg_list argFrame, int offset, type-name, type-name value) 
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Selector Functions 


Match method names with method selectors: 

SEL seI_getUid(const char *aName) 

const char * sel_getName(SEL aSelector ) 

Determine whether a selector is valid: 

BOOL sel_isMapped(SEL aSelector ) 

Register a method name: 

SEL sel_registerName(const char *aName ) 
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Types and Constants 


Defined Types 

Cache 

typedef struct objc_cache *Cache; 

Category 

typedef struct objc_category * Category; 

Ivar 

typedef struct objc_ivar *Ivar; 

margjist 

typedef void *marg_list; 

Method 

typedef struct objcjnethod *Method; 

Module 

typedef struct objc_module *ModuIe; 
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Symbolic Constants 


Type Constants 


Meaning 


Defined As 


_C_ID 

id 


_C_CLASS 

Class 

*#’ 

_C_SEL 

SEL 


_C_VOID 

void 

V 

_C_CHR 

char 

‘c’ 

_C_UCHR 

unsigned char 

‘C 

_C_SHT 

short 

‘s’ 

_C_USHT 

unsigned short 

‘S’ 

_C_INT 

int 

T 

_C_UINT 

unsigned int 

T 

_C_LNG 

long 

‘1’ 

_C_ULNG 

unsigned long 

‘L’ 

_C_FLT 

float 

‘f 

_C_DBL 

double 

‘d’ 

_C_UNDEF 

an undefined type 

*?» 

_C_PTR 

a pointer 

‘A’ 

_C_CHARPTR 

char * 


_c_bfld 

a bitfield 

‘b’ 

_C_ARY_B 

begin an array 

T 

_C_ARY_E 

end an array 

T 

_C_UNION_B 

begin a union 

•(’ 

_C_UNION_E 

end a union 

y 

_C_STRUCT_B 

begin a structure 

T 

_C_STRUCT_E 

end a structure 

T 


Structures 

objc_cache 

struct objc_cache { 

unsigned int mask; 
unsigned int occupied; 
Method buckets[l]; 
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objc_category 

struct objc_category { 

char * categoryjname; 
char *class_name; 

struct objc_method_list *instance_methods; 
struct objc_method_list *class_methods; 
struct objc_protocol_list ^protocols; 

}; 


objc_class 

struct objc_class { 

struct objc_class *isa; 

struct objc_class *super_class; 

const char *name; 

long version; 

long info; 

long instance_size; 

struct objc_ivar_list *ivars; 

struct objc_method_list *methods; 

struct objc_cache *cache; 

struct objc_protocol_list ^protocols; 

}; 


objcjvar 

struct objc_ivar { 

char *ivar_name; 
char *ivar_type; 
int ivar_offset; 

}; 


objcjvarjist 

struct objc_ivar_Iist { 
int ivar_count; 
struct objc_ivar ivar_Iist[l]; 

}; 
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objc_method 

struct objc_method { 

SEL method_name; 
char *method_ types; 
IMP method_imp; 


objc_method_description 

struct objc_method_description { 
SEL name; 
char *types; 

}; 


objc_method_description_list 

struct objc_method_description_Iist { 
int count; 

struct objc_method_description list[l]; 

}; 


objc_method_list 

struct objc_method_list { 

struct objc_method_list *method_next; 

int method_count; 

struct objc_method method_list[l]; 

}; 


objc_module 

struct objc_module { 

unsigned long version; 
unsigned long size; 
const char *name; 
Symtab symtab; 
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objc_protocol_list 

struct objc_protocol_list { 

struct objc_protocol_list *next 
int count; 

Protocol *list[l]; 

}; 

objc_super 

struct objc_super { 
id receiver; 

Class class; 

}; 


Global Variables 

Function Pointers 

id (*_alloc) (Class aClass, unsigned int indexedlvarBytes ) 

id (*_dealloc) (Object *anObject) 

id (*_realloc) (Object *anObject, unsigned int numBytes ) 

id (*_copy) (Object *anObject, unsigned int indexedlvarBytes) 

id (*_zoneAIloc) (Class aClass, unsigned int indexedlvarBytes, NXZone *zone) 

id (*_zoneRealloc) (Object *anObject, unsigned int numBytes, NXZone *zone) 

id (*_zoneCopy) (Object *anObject, unsigned int indexedlvarBytes, NXZone *zone) 

id (*_error) (Object *anObject, char * format, va_list ap ) 
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Sound 


1 ] 



Classes 


NXPlayStream 


Inherits From: NXSoundStream : Object 

Initializing an NXPlayStream 

- initOnDeviceuznObject Initializes a newly allocated NXPlayStream 

Activating and Playing 

- (NXSoundDeviceError)activate Prepares the NXPlayStream for playback 

- (NXSoundDeviceError)playBuffer:(void *)data Plays a buffer of sound 

size: (unsigned int )bytes 
tag:(int)a7iag 

channelCount:(unsigned int)channels 
samplingRate:(float)rare 
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- (NXSoundDeviceError)playBuffer:(void *)data Plays a buffer of sound 

size:(unsigned mt)bytes 
t&g:(mt)aTag 

channelCount:(unsigned int )channels 
sampIingRate:(float)rate 
bufferGainLeft:(float)/e/Mmp 
right:(float)r/g/i tAm/? 
lowWaterMark:(unsigned int )lowWater 
highWaterMark: (unsigned mt)highWater 

Setting Gain and Peak Detection 

- (NXSoundDeviceError)setGainLeft:(float)/e/Mmp Sets the NXPlayStream’s stereo gain 

right: (f\oat)rightAmp 

- getGainLeft:(float *)leftScale Returns the NXPlayStream’s gain by reference 

right:(float *)rightScale 

- (NXSoundDeviceError)getPeakLeft:(float *)leftAmp 

right:(float *)rightAmp Returns the most recent peak amplitudes by reference 

- (NXSoundDeviceError)setDetectPeaks:(BOOL)/fag 

Sets whether the NXPlayStream will detect peaks 

- (BOOL)isDetectingPeaks Returns whether the NXPlayStream is detecting peaks 

- (NXSoundDeviceError)setPeakHistory: (unsigned int) bufferCount 

Sets the number of buffers over which peaks are detected 

- (unsigned int)peakHistory Returns the number of buffers over which peaks are 

detected 

Delegate Methods 

- soundStreamDidUnderrunrender Invoked when the sound driver underruns 


NXRecordStream 


Inherits From: NXSoundStream : Object 


Enqueueing Buffers 

- (NXSoundDeviceError)recordSize: (unsigned int )bytes 

tag: (int )anlnt Enqueues a recording buffer 
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- (NXSoundDeviceError)recordSize:(unsigned int )bytes 

tag:(int )aTag Enqueues a recording buffer 

lowWaterMark:(unsigned mt)lo\vWater 
high WaterMark: (unsigned int )high Water 


Requesting Data 

- (NXSoundDeviceError)sendRecordedDataToDelegate 

Sends the current buffer to the delegate 


Delegate Methods 

- soundStreamDidOverrunrsender Invoked when the sound driver overruns 

- soundStreamDidRecordData:(void *)data Delivers a buffer of recorded data 

size:(unsigned m\)numBytes 
forBuffer:(int)tag 


NXSoundDevice 

Inherits From: Object 

Initializing and Freeing an NXSoundDevice 

- init 

- initOnHost: (const char *)hostName 

-free 

Using a Separate Thread 

+ (cthread_t)replyThread 
+ setUseSeparateThread:(BOOL)/fag 
+ (BOOL)isUsingSeparateThread 

+ setThreadThreshold:(int)t/zre5/zoW 
+ (int)threadThreshoId 


Initializes a newly allocated NXSoundDevice 
Initializes a new NXSoundDevice on the given host 
Frees the NXSoundDevice 


Returns the thread in which driver messages are sent 
Sets whether a separate thread is used for driver messages 
Returns whether a separate thread is used for driver 
messages 

Sets the message-reception threshold 
Returns the message-reception threshold 
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Examining Ports 

- (port_t)devicePort 
+ (port_t)replyPort 

- (port_t)streamOwnerPort 


Returns the port used to communicate with the sound driver 
Returns the port to which the sound driver sends messages 
Returns the port used to connect to the sound driver 


Identifying the Host Computer 

- (const char *)host 


Returns the name of the computer on which the 
NXSoundDevice was initialized 


Configuring the Object 

- (NXSoundDeviceError)setBufferCount:(unsigned mt)count 

Sets the number of DMA buffers for the sound device 

- (unsigned int)bufferCount Returns the number of DMA buffers for the sound device 

- (unsigned int)bufferSize Returns the size in bytes of each DMA buffer 

- (NXSoundDeviceError)setReserved:(BOOL)/?ag 

Sets whether the underlying device is reserved 

- (BOOL)isReserved Returns whether the underlying device is reserved 

- (NXSoundDeviceError)setBufferSize:(unsigned int )bytes 

Sets the size in bytes of each DMA transfer buffer 

+ setTimeout: (unsigned mt)milliseconds Sets the timeout period 

+ (unsigned int)timeout Returns the timeout period 


Finding Peak Amplitudes 

- (NXSoundDeviceError)getPeakLeft:(float *)leftAmp 

right:(float *)rightAmp Returns the most recent peak amplitudes by reference 

- (NXSoundDeviceError)setDetectPeaks:(BOOL)//ag 

Sets whether the NXSoundDevice will detect peaks 

- (BOOL)isDetectingPeaks Returns whether the NXSoundDevice is detecting peaks 

- (NXSoundDeviceError)setPeakHistory:(unsigned int )bufferCount 

Sets the number of buffers over which peaks are detected 

- (unsigned int)peakHistory Returns the number of buffers over which peaks are 

detected 


Controlling Streams 

- abortStreamsisender 

- pauseStreams:se«<ier 

- resumeStreamsisemfer 


Aborts all streams connected to this NXSoundDevice 
Pauses all streams connected to this NXSoundDevice 
Resumes all streams connected to this NXSoundDevice 
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Handling errors 


- (NXSoundDeviceError)lastError Returns the most recent error 

+ (const char *)textForError:(NXSoundDeviceError)em?rCWe 

Returns a string that describes the given error 


IMXSoundln 

Inherits From: NXSoundDevice : Object 

Finding the Device Port 

+ (port_t)lookUpDevicePortOnHost:(const char *)hostName 

Returns the sound-in port on hostName 


NXSoundOut 

Inherits From: NXSoundDevice : Object 

Setting Attributes for Sound Output 

- (NXSoundDeviceError)setAttenuationLeft:(float)/<?/fDfl 

right:(float )rightDB Sets the attenuation level for playback 

- (NXSoundDeviceError)setDeemphasis:(BOOL)/7ag 

Sets the state of the de-emphasis filter 

- (NXSoundDeviceError)setInsertsZeros:(BOOL)//ag 

Sets the way in which the driver converts low to high 
sampling rate 

- (NXSoundDeviceError)setRampsDown:(BOOL)/fag 

Sets whether the end of sounds are ramped 

- (NXSoundDeviceError)setRampsUp:(BOOL)//ag Sets whether the beginning of sounds are ramped 

- (NXSoundDeviceError)setSpeakerMute:(BOOL)/fag 

Mutes or unmutes the internal speaker 
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Querying Sound Output Settings 

- (BOOL)doesDeemphasize 

- (BOOL)doesInsertZeros 

- (BOOL)doesRampDown 

- (BOOL)doesRampUp 

- (NXSoundDeviceError)getAttenuationLeft 

right:(float *)rightDB 

- (BOOL)isSpeakerMute 

- (unsigned int)cIipCount 


Returns whether the de-emphasis filter is turned on 

Returns whether the sound driver inserts zeros when it 
converts low to high sampling rate. 

Returns whether the end of a sound stream is ramped down 
Returns whether the start of a sound stream is ramped down 
:(float *)leftDB 

Returns the attenuation settings by reference 
Returns whether the internal speaker is muted 
Returns the number of sample frames that were clipped 


Finding the Device Port 

+ (port_t)lookUpDevicePortOnHost: (const char *)hostName 

Returns the sound-out port on hostName 


NXSoundStream 

Inherits From: Object 

Initializing and Freeing an NXSoundStream 
-init 

- initOnDevice:aDmc<? 

- free 

Setting the Device 

- (NXSoundDeviceError)setDevice:«Device 

- device 

Activating and Deactivating 

- (NXSoundDeviceError)activate 

- (NXSoundDeviceError)deactivate 


Initializes the NXSoundStream 

Initializes the NXSoundStream and connects it to aDevice 
Deactivates and frees the NXSoundStream. 


Connects the NXSoundStream to aDevice 

Returns the NXSoundDevice that the NXSoundStream is 
connected to. 


Adds the NXSoundStream to the list of active streams 
Aborts the NXSoundStream’s current activity 
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Controlling the stream 

- abort ‘.sender Stops the NXSoundStream’s playback or recording 

- (NXSoundDeviceError)abortAtTime:(NXSoundStreamTime *)time 

Schedules the NXSoundStream to be aborted 

- paus e:sender Pauses the NXSoundStream’s recording or playback 

- (NXSoundDeviceError)pauseAtTime:(NXSoundStreamTime *)time 

Schedules the NXSoundStream to be paused 

- resume ‘.sender Resumes the NXSoundStream’s recording or playback 

- (NXSoundDeviceError)resumeAtTime:(NXSoundStreamTime *)time 

Schedules the NXSoundStream to be resumed 


Querying the Object 

- (unsigned int)bytesProcessed 

- (BOOL)isActive 

- (BOOL)isPaused 

- (port_t)streamPort 

- (NXSoundDeviceError)lastError 

Assigning a Delegate 

- seiDclegatcianObject 

- delegate 

Delegate Methods 

- soundStreamisenfifer didCompleteBuffer:(int)tag 

- soundStream:^eu<ier didStartBuffer:(int)tag 

- souiidStreamI)idAbort:.vew/er 

deviceReserved: (B OOL )flag 

- soundStreamDidPause:sender 

- soundStreamDidResumeisenefer 


Returns the number of bytes of sound that the 
NXSoundStream has recorded or played 

Returns whether the NXSoundStream is currently activate 
Returns whether the NXSoundStream is currently paused 
Returns the port used to connect to the sound driver 
Returns the most recent sound device error 


Sets the NXSoundStream’s delegate. 
Returns the NXSoundStream’s delegate. 


Invoked when the driver finishes playing or recording 
Invoked when the driver starts playing or recording 
Invoked when the driver aborts the stream 

Invoked when the NXSoundStream is paused 
Invoked when the NXSoundStream is resumed 
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Sound 


Inherits From: Object 

Conforms To: soundkit/Sound.h 

Creating and Freeing a Sound Object 

+ addName:(const char *)name 

fromBundIe:(NXBundle *)aBundle 

+ addName: (const char *)name 

fromSection:(const char ^sectionName 
+ addName:(const char *)name 

fromSoundfile: (const char *)filename 

- initFromSection:(const char *)sectionName 

- initFromPasteboard:(Pasteboard *)thePboard 

- initFromSoundfile:(const char *)filename 

-free 

Accessing the Sound Name Table 

+ addName:(const char *)name sound laSound 

+ findSoundFor:(const char *)aName 
+ removeSoundForName:(const char *)name 

Accessing the Sound's Name 

- setName:(const char *)aName 

- (const char *)name 

Reading and Writing Sound Data 

- (int)readSoundfile: (const char *)filename 

- readSoundFromStream:(NXStream *)stream 

- (int)writeSoundfile:(const char *)filename 

- writeSoundToStream:(NXStream *)stream 

- (int)writeToPasteboard:(Pasteboard *)pboard 


Creates a Sound object from the sound resource named 
name in the NXBundle aBundle 

Creates a Sound object from the sectionName section 
of the sound segment in the application executable file 
Creates a Sound object from filename 

Creates a Sound object from the sectionName section of the 
sound segment in the application executable file 
Creates a Sound object from the named pasteboard 
Creates a Sound object from filename 
Frees the Sound object 


Assigns the name name to the Sound aSound and adds it to 
the name table 

Finds and returns the named Sound object 
Removes the named Sound from the name table 


Set’s the Sound object’s name 
Return’s the Sound object’s name 


Replaces the Sound’s data with that in filename 

Replaces the Sound’s data with that read from stream 

Writes the Sound’s data to filename 

Writes the Sound’s data to stream 

Writes the Sound’s data to the named pasteboard 
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Modifying Sound Data 

- (int)convertToFormat:(int)newF<9rma? 

samplingRate: (doub\o)newRate 
c\mimc\Co\mt:(mt)newChannelCoimt 

- (int)convertToFormat:(int)nevvFc>rmat 

- (int)setDataSize:(int)newDataSize 

dataFormat:(int )newDataFormat 
samplingRate: (doubl e)newSamplingRate 
channelCount:(int)newChannelCount 
infoSize:(int )newInfoSize 

- setSoundStruct:(SNDSoundStruct *)aStruct 

soundStructSize: (int)size 

Querying the Sound Data 

- (SNDSoundStruct *)soundStruct 

- (int)soundStructSize 

- (unsigned char *)data 

- (int)dataFormat 

- (int)dataSize 

- (int)channelCount 

- (double)samplingRate 

- (int)sampleCount 

- (double)duration 

- (char *)info 

- (int)infoSize 

- (BOOL)isEmpty 

- (BOOL)compatibleWith:a5on/2<i 

Recording and playing 

- (int)pause 

- paus e:sender 

- (BOOL)isPlayable 

- (int)play 

- playisender 

- (int)record 

- record '.sender 

- (int)resume 


Converts the Sound’s data to the specified format, 
sampling rate, and channel count 

Convert’s the Sound’s data to the specified format 
Set’s the Sound’s data as specified 


Set’s the Sound’s sound structure 


Returns the Sound’s sound structure 
Gives the size of the Sound’s sound structure 
Returns a pointer to the Sound’s sound data 
Returns the Sound’s data format 
Returns the size in bytes of the Sound’s data 
Returns the number of channels of sound 
Returns the sound data’s sampling rate 
Returns the number of sample frames in the sound data 
Returns the sound’s length in seconds 
Returns a pointer to the Sound’s info string 
Returns the length in bytes of the Sound’s info string 
Returns whether the Sound contains any sound data 
Returns whether the Sound’s format is compatiable with 
that of aSound 


Pauses the Sound’s activity 

Pauses the Sound’s activity 

Returns whether the Sound can be played 

Plays the Sound 

Plays the Sound 

Records into the Sound 

Records into the Sound 

Resumes the Sound’s activity 
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- resume '.sender 

- (int)stop 

- stop '.sender 

- (int)samplesProcessed 

- (int)status 

- soundBeingProcessed 

- (SNDSoundStruct *)soundStructBeingProcessed 

- (int)processingError 

Editing Sound Data 

- (BOOL)isEditable 

- (inOcopySamplesjaStfirnd 

at:(int )startSample 
count:(in t)sampleCount 

- (intjcopySoundiaSowmi 

- (int)deleteSamples 

- (int)deleteSamples At: (int)startSample 

count:(int )sampleCount 

- (int)insertSamples:fl5o«nJ at:(int )startSample 

- (BOOL)needsCompacting 

- (int)compactSamples 

Archiving the Object 

- finishUnarchiving 

- read:(NXTypedStream *)stream 

- write:(NXTypedStream *)stream 

Accessing the Delegate 

- seiDelegaie:anObject 

- delegate 

- tellDelegate:(SEL )theMessage 

Accessing the Sound Hardware 

+ getVolume:(float *)left :(float *)right 
+ setVolume:(float)/e/r :(fioai)right 


Resumes the Sound’s activity 
Stops the Sound’s activity 
Stops the Sound’s activity 

Returns the number of sample frames played or recorded 
Returns the Sound’s activity code 
Returns self 

Returns the sound structure that’s being played or recorded 
Returns the last error code that was generated 


Returns whether the Sound’s data can be edited 
Copies a range of samples from aSound into the receiver 

Replaces the Sound’s data with that in aSound 
Removes the Sound’s data 

Removes a range of samples from the Sound’s data 

Inserts aSound’s data into the Sound’s data 

Returns whether the Sound’s data needs to be compacted 

Compacts the Sound’s data 


Invoked automatically after unarchiving 
Unarchives the Sound from stream 
Archives the Sound to stream 


Sets the Sound’s delegate object 
Returns the Sound’s delegate 
Sends theMessage to the delegate 


Returns the left and right volume settings by reference 
Sets the left and right volumes (0.0 to 1.0) 
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+ (BOOL)isMuted 
+ setMute:(BOOL)< 2 F/flg 


Returns whether the internal speaker is muted 
Sets whether the internal speaker is muted 


Delegate Methods 

- didPlay :sender 

- didRecordtsender 

- hadError:.s<?«der 

- willPlay:.s£M<ier 

- willRecord:.s<?nzfer 


Sent to the delegate when the Sound stops playing 
Sent to the delegate when the Sound stops recording 

Sent to the delegate if an error occurs during recording or 
playback 

Sent to the delegate when the Sound begins to play 
Sent to the delegate when the Sound begins to record 


SoundMeter 


Inherits From: View : Responder : Object 


Initializing a SoundMeter 

- initFrame:(const NXRect *)frameRect Initializes the SoundMeter 


Graphic Attributes 

- setBackgroundGray:(float)aVfr/w<? 

- (float)backgroundGray 

- setForegroundGray:(float)aVb/ne 

- (float)foregroundGray 

- setBezeled:(BOOL)«F/ag 

- (BOOL)isBezeled 

- setPeakGray:(float)aVb/«e 

- (float)peakGray 


Sets the SoundMeter’s background color 
Returns the SoundMeter’s background color 
Sets the SoundMeter’s running bar color 
Returns the color of the running bar 
Sets whether a bezeled border is drawn 
Returns whether the SoundMeter has a border 
Sets the SoundMeter’s peak bubble color 
Returns the SoundMeter’s peak bubble gray 


Metering Attributes 

- setSoundmSoimd Sets the SoundMeter’s Sound object 

- sound Returns the Sound object that the SoundMeter is metering 
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- setFloatValue:(float)aV&/w<? 

- setHoldTime:(float)^ec<9A2^s 

- (float)holdTime 

Retrieving Meter Values 

- (float)floatValue 

- (float)max Value 

- (float)min Value 

- (float)peak Value 

Operating the Object 

- run ‘.sender 

- (BOOL)isRunning 

- stop: sender 

Drawing the Object 

- drawCurrentValue 

- drawSelf:(const NXRect *)rects :(int )rectCount 

Archiving 

- read:(NXTypedStream *)aStream 

- write:(NXTypedStream *)aStream 


Sets the current running value 

Sets the SoundMeter’s peak value hold time in seconds 

Returns the SoundMeter’s peak hold time 


Returns the current running amplitude value 
Returns the maximum running value so far 
Returns the minimum running value so far 
Returns the most recently detected peak value 


Starts the SoundMeter running 

Returns whether the SoundMeter is currently running 

Stops the SoundMeter’s metering activity 


Draws the SoundMeter’s running bar and peak bubble 
Draws all the components of the SoundMeter 


Unarchives the SoundMeter by reading it from aStream 
Archives the SoundMeter by writing it to aStream 


SoundView 


Inherits From: View : Responder : Object 

Initializing and Freeing a SoundView 

- initFrame:(const NXRect *)frameRect Initializes the SoundView 

- free Frees the SoundView 
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Modifying the Object 


- scaleToFit 

- setBackgroundGray:(float)aGray 

- setBezeled:(BOOL)aF/ag 

- setContinuous:(BOOL)aF/ag 

- setDelegateianObject 

- setDisp!ayMode:(int)flMo^e 

- setEnabled:(BOOL)aF/<2g 

- setForegroundGray:(float)aGray 

- setOptimizedForSpeed:(BOOL)/fag 

- setSoundiaSound 

- sizeToFit 


Fits the sound data within the current frame 
Sets the SoundView’s background gray 
Sets whether the SoundView has a bezeled border 
Sets the state of continuous action messages. 

Sets the SoundView’s delegate 
Sets the SoundView’s display mode 
Enables or disables the SoundView 
Sets the SoundView’s foreground gray 

Sets whether the SoundView’s display mechanism is 
optimized 

Sets the SoundView’s Sound object 
Resizes the SoundView’s frame to maintain a constant 
reduction factor 


Querying the Object 


- (float)backgroundGray 

Returns the SoundView’s background gray 

- delegate 

Returns the SoundView’s delegate 

- (int)displayMode 

Returns the SoundView’s display mode 

- (float)foregroundGray 

Returns the SoundView’s foreground gray 

- getSelection:(int *)firstSample 


size:(int *)sampleCount 

Returns the selection by reference 

- (BOOL)isAutoScale 

Returns whether the SoundView is in autoscaling mode 

- (BOOL)isBezeled 

Returns whether the SoundView has a bezeled border 

- (BOOL)isContinuous 

Returns whether the SoundView responds to 


(B OOL)isEnabled 
(BOOL)isOptimizedForSpeed 

(float)reductionFactor 

sound 


mouse-dragged events 
Returns whether the SoundView is enabled 
Returns whether the SoundView is optimized for speedy 
display 

Returns the SoundView’s reduction factor 
Returns the SoundView’s Sound object. 


Selecting and Editing the Sound Data 

- copy: sender 

- cut '.sender 

- delet eisender 

- mouseDown:(NXEvent *)theEvent 


Copies the current selection to the pasteboard 
Deletes the current selection 
Deletes the current selection 
Allows a selection to be defined 
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- paste: sender 

- selectAll: sender 

- setSelection:(int)firstSample size:(in t)sampleCount 

- (BOOL)isEditable 

- setEditable:(BOOL)aF/a^ 


Replaces the current selection 

Creates a selection over the SoundView’s entire sound 

Sets the selection 

Returns whether the SoundView’s data can be edited. 
Sets whether the SoundView can be edited 


Pasteboard and Services Support 

- pasteboard :thePasteboard provideData:(const char *)pboardType 

Places the SoundView’s sound on the given pasteboard 

Replaces the SoundView’s current selection 


-readSelectionFromPasteboardrr/iePas/e&oa/r/ 

- validRequestorForSendiype: (NXAtom),sew/7ype 

andRetumType:(NXAtom)r<?mrtt7y/?c 

- writeSelectionToPasteboardir/ze/WeZward 

types:(NXAtom *)pboardTypes 

Modifying the Display Coordinates 

- set Autoscale :(BOOL)aFlag 

- setReductionFactor: (float )reductionFactor 

Drawing the Object 

- drawSelf:(const NXRect *)rects :(int )rectCount 

- drawSamplesFrom:(int)/iryt to:(int)/aV 

- hideCursor 

- showCursor 

- sizeTo:(NXCoord)inVfr/i :(NXCoor d)height 

Responding to Events 

- (BOOL)acceptsFirstResponder 

- becomeFirstResponder 

- resignFirstResponder 

Performing the Sound Data 

- (BOOL)isPlayable 

- play '.sender 

- record '.sender 


You never invoke this method 

Places a copy of the SoundView’s current selection 
on the given pasteboard 


Sets the SoundView’s automatic scaling mode 
Recomputes the size of the SoundView’s frame 


Displays the SoundView’s sound data 

Redisplays the given range of samples 

Hides the SoundView’s cursor 

Displays the SoundView’s cursor 

Sets the width and height of the SoundView’s frame 


Returns YES 

Promotes the SoundView to first responder 
Resigns the position of first responder 


Returns whether the SoundView’s sound can be played 

Play the current selection 

Replaces the SoundView’s current selection 
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- paus ^'.sender 

- resume: sender 

- stop '.sender 

- soundBeingProcessed 

Archiving the Object 

- read:(void *)stream 

- write:(void *) stream 

Accessing the Delegate 

- didPlay : sender 

- didRecordrsender 

- hadError:se/ider 

- tellDelegate:(SEL)t/ieMessn^e 

- willPlay: sender 

- will Reco rd: sen de r 

Delegate Methods 

- didPlay '.sender 

- didRecordrsender 

- hadError:sender 

- selectionChanged:sender 

- soundDid Change: sender 

- willFree:sender 

- willPlay:sender 

- willRecord:sender 


Pauses the current playback or recording 

Resumes the current playback or recording 

Stops the SoundView’s current recording or playback 

Returns the Sound object that’s currently being played or 
recorded into 


Unarchives the SoundView by reading it from stream 
Archives the SoundView by writing it to stream 


Used to redirect delegate messages 

Used to redirect delegate messages 

Used to redirect delegate messages 

Sends theMessage to the SoundView’s delegate 

Used to redirect delegate messages 

Used to redirect delegate messages 


Sent to the delegate just after the SoundView is played. 

Sent to the delegate just after the SoundView is recorded 
into. 

Sent to the delegate if an error is encountered . 

Sent to the delegate when the SoundView’s selection 
changes. 

Sent to the delegate when the SoundView’s sound is edited 

Sent to the delegate when the SoundView is freed. 

Sent to the delegate just before the SoundView’s sound is 
played. 

Sent to the delegate just before the SoundView’s sound is 
recorded into. 
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Sound Functions 


Accessing Sound Devices and Hardware 


Access sound devices 

int SNDAcquire(int soundResource, int priority, int preempt, int timeout, 

SNDNegotiationFun negFuti, void *arg, port_t *devicePort, 
port_t *ownerPort) 

int SNDReset(int soundResource, port_t devicePort, port_t ownerPort) 

int SNDReIease(int soundResource, port_t * devicePort, port_t *ownerPort) 


Reserve sound devices for recording or playback 

int SNDReserve(int soundResource, int priority) 

int SNDUnreserve(int soundResource) 

Set the host computer for subsequent playback or recording 

int SNDSetHost(char *newHostname) 

Sound playback utilities 

int SNDSetVolume(int left, int right) 

int SNDGetVoIume(int Heft, int * right) 

int SNDSetMute(int speakerOn) 

int SNDGetMute(int *speakerOri) 

int SNDSetFilter(int./?//erOn) 

int SNDGetFiIter(int *filterOri) 


Recording and Playing 


Play a soundfile 

int SNDPlaySoundfile(char *path, int priority) 
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Recording and playing a sound 

int SNDStartPlaying(SNDSoundStruct *sound, int tag, int priority, int preempt, 

SNDNotificationFun beginFun, SNDNotificationFun endFun ) 
int SNDVerifyPlayabIe(SNDSoundStruct *sound) 

int SNDStartRecording(SNDSoundStruct *sound, int tag, int priority, int preempt, 

SNDNotificationFun beginFun, SNDNotificationFun endFun ) 
int SNDStartRecordingFile(char *fileName, SNDSoundStruct *sound, int tag, 

int priority, int preempt, SNDNotificationFun beginFun, 
SNDNotificationFun endFun) 

int SNDStop(int tag) 

int SNDWait(int tag) 

int SNDSamplesProcessed(int tag) 

int SNDModifyPriority(int tag, int newPriority) 


Reading and Writing Soundfiles 


Read a sound from a file 

int SNDReadSoundfile(char *path, SNDSoundStruct ** sound) 

int SNDRead(int fd, SNDSoundStruct ** sound) 

int SNDReadHeader(int/J, SNDSoundStruct **sound) 

int SNDReadDSPfile(char *path, SNDSoundStruct ** sound, char *info) 


Write a sound to a file 

int SNDWriteSoundfile(char *path, SNDSoundStruct *sound) 

int SNDWrite(int/<i, SNDSoundStruct * sound) 

int SNDWriteHeader(int/d, SNDSoundStruct *sound) 


Accessing Sound Data 


Create and free a sound structure 

int SNDAIloc(SNDSoundStruct **sound, int dataSize, int dataFormat, 

int samplingRate, int channelCount, int infoSize) 
int SNDFree(SNDSoundStruct *sound) 
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Gain access to sampled sound data 


int SNDGetDataPointer(SNDSoundStruct *sound, char **ptr, int *size, int *width ) 

Measure samples in a sound 

int SNDSampleCount(SNDSoundStruct *sound) 

int SNDBytesToSamples(int byteCount, int channelCount, int dataFormat) 

int SNDSamplesToBytes(int sampleCount, int channelCount , int dataFormat) 


Accessing the DSP 

Boot the DSP 

int SNDBootDSP(port_t *devicePort, port_t *ownerPort, SNDSoundStruct *dspCore) 

Run the DSP 

int SNDRunDSP(SNDSoundStruct *dspCore, char *toDSP, int toCount, int toWidth, 

int toBufferSize, char **fromDSP, int *fromCount, int fromWidth, 
int negotiationTimeout, int flushTimeout, int conversionTimeout) 


Compressing Sound Data 


Compress or decompress a sound 

int SNDCompressSound(SNDSoundStruct *fromSound, 

SNDSoundStruct **toSound, BOOL bitFaithful, 
int compressionAmount ) 


Query for frequency bands used by Audio Transform Compression 

int SNDGetNumberOfATCBands(int *numBands ) 

int SNDGetATCBandFrequencies(int numBands, float *centerFreqs) 

int SNDGetATCBandwidths(int numBands, float *bandwidths) 
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Speed up or slow down playback of ATC sound 

int SNDDropATCSamples(int numSamples, int bySamples ) 

int SNDInsertATCSamples(int numSamples, int bySamples) 


Modify volume or equalization for ATC playback 

int SNDSetATCGain(float level ) 

int SNDGetATCGain(float *level) 

int SNDSetATCEqualizerGains(int numBands, float * gains) 

int SNDGetATCEqualizerGains(int numBands, float *gains) 

int SNDScaleATCEqualizerGains(int numBands, float *gainScalars) 

Set or get ATC parameters 

int SNDSetATCSquelchThresholds(int numBands, float * thresholds) 

int SNDGetATCSquelchThresholds(int numBands, float * thresholds ) 

int SNDUseDefaultATCSquelchThreshoIds(void) 


Set and get compression attributes used in recording 

int SNDSetCompressionOptions(SNDSoundStruct *sound, int bitFaithful, 

int compressionAmount ) 

int SNDGetCompressionOptions(SNDSoundStruct *sound, int * bitFaithful, 

int * compressionAmount) 


Converting Sound Data 


Convert between logarithmic and linear units 

float SNDConvertDecibelsToLinear(float dB) 

float SNDConvertLinearToDecibels(float linear) 

Convert a sound's attributes 

int SNDConvertSound(SNDSoundStruct *fromSound, SNDSoundStruct **toSound) 

unsigned char SNDMulaw(short linearValue) 

short SNDiMulaw(unsigned char mulawValue) 


Sound Functions 16-19 




Editing Sound Data 


Copy all or part of a sound 

int SNDCopySound(SNDSoundStruct **toSound, SNDSoundStruct *fromSound) 

int SNDCopySamples(SNDSoundStruct **toSound, SNDSoundStruct *fromSound, 

int startSample, int sampleCount) 


Edit a sampled sound 

int SNDInsertSamples(SNDSoundStruct *toSound, SNDSoundStruct *fromSound, 

int startSample ) 

int SNDDeleteSamples(SNDSoundStruct *sound, int startSample, int sampleCount) 

int SNDCompactSamples(SNDSoundStruct **toSound, 

SNDSoundStruct *fromSound) 


Sound Errors 


Describe a sound error 

char *SNDSoundError(int err) 
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Driver Functions 


DSP Functions 


Start the DSP: 

kem_retum_t snddriver_dsp_boot(port_t commandPort, int *bootImage, int imageSize, 

int priority) 

kem_retum_t snddriver_dsp_reset(port_t commandPort, int priority) 

Transfer data to and from the DSP via DMA 

kem_retum_t snddriver_dsp_dma_write(port_t commandPort, int elementCount, 

int dataFormat, pointer_t data) 

kem_retum_t snddriver_dsp_dma_read(port_t commandPort, int elementCount, 

int dataFormat, pointer_t data ) 


Enqueue a DSP command 

kem_retum_t snddriver_dsp_host_cmd(port_t commandPort, u_int hostCommand, 

u_int priority) 

Set the sound driver's protocol vis-a-vis the DSP 

kem_retum_t s nddriver_dsp_protocol(port_t devicePort, port_t ownerPort, int protocol) 

Set the DSP host flags 

kem_retum_t snddriver_dsp_set_flags(port_t commandPort, u_intflagMask,u_intflagValue, 

u_int priority) 


Transfer data to and from the DSP 


kem_retum_t 

kem_retum_t 

kem_retum_t 

kem_retum_t 


snddriver_dsp_write(port_t commandPort, void *buffer, int elementCount, int 
elementSize, int priority) 

snddriver_dsp_read(port_t commandPort, void *buffer, int elementCount, int 
elementSize, int priority) 

snddriver_dsp_read_messages(port_t commandPort, void *bujfer, 
int elementCount, int elementSize, int priority) 
snddriver_dsp_read_data(port_t commandPort, void **buffer, int elementCount, 
int elementSize, int priority) 
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Request a DSP host interface register condition 

kem_retum_t snddriver_dspcmd_req_condition(port_t commandPort, u_int registerMask, 

u_int conditionFlags, int priority, port_t replyPort ) 

Request the contents of the DSP-reply buffers 

kem_retum_t snddriver_dspcmd_req_msg(port_t commandPort, port_t replyPort) 

kem_retum_t snddriver_dspcmd_req_err(port_t commandPort, port_t replyPort ) 

Get the DSP command port 

kem_retum_t snddriver_get_dsp_cmd_port(port_t devicePort, port_t ownerPort, 

port_t * commandPort ) 


Driver Setup and Access 


Acquire ownership of sound resources 

kem_retum_t snddriver_set_dsp_owner_port(port_t devicePort, port_t ownerPort, 

port_t *negotiationPort) 

kem_retum_t snddriyer_set_sndin_owner_port(port_t devicePort, port_t ownerPort, 

port_t *negotiationPort) 

kem_retum_t snddriver_set_sndout_owner_port(port_t devicePort, port_t ownerPort, 

port_t *negotiationPort) 

Reallocate the sound driver device port 

kem_retum_t snddriver_new_device_port(port_t devicePort, port_t superuserPort, 

port_t *newDevicePort) 

Respond to asynchronous sound driver messages 

kem_retum_t snddriver_reply_handler(msg_header_t *reply, snddriver_handlers_t * handlers ) 
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Set and get sound playback attributes 


kem_retum_t 

kem_retum_t 

kem_retum_t 

kern_retum_t 

kem_retum_t 


snddriver_set_device_parms(port_t devicePort, boolean_t speakerOn, 
boolean_t filterOn, boolean_t zerofill ) 
snddriver_get_device_parms(port_t devicePort , boolean_t * speakerOn, 
boolean_t *filterOn, boolean_t *zerofill) 
snddriver_set_\olume(port_t devicePort, int leftVolume, int rightVolume ) 
snddriver_get_volume(port_t devicePort, int * leftVolume, int * rightVolume ) 
snddriver_set_ramp(port_t devicePort, int ramp On ) 


Stream Setup and Access 


Configure stream transfer buffers 

kem_return_t snddriver_set_sndout_bufcount(port_t devicePort, port_t sndoutPort, int count ) 
kem_retum_t snddriver_set_sndout_bufsize(port_t devicePort, port_t sndoutPort, int size) 
kem_retum_t snddriver_stream_ndma(port_t streamPort, int regionTag, int count) 

Control and query a stream 

kem_retum_t snddriver_stream_controI(port_t streamPort, int regionTag, int control) 
kem_retum_t snddriver_stream_nsamples(port_t streamPort, int *byteCount) 

Configure a sound stream 

kem_retum_t snddriver_stream_setup(port_t devicePort, port_t ownerPort, int dataPath, 

int sampleCount, int sampleSize, int lowWater, int highWater, 
int * protocol, port_t * streamPort ) 

Send data to and retrieve data fom a stream 

kem_retum_t snddriver_stream_start_writing(port_t streamPort, void *data, int sampleCount, 

int regionTag, boolean_t preempt, 
boolean_t deallocateWhenDone, boolean_t msgStarted, 
boolean_t msgCompleted, boolean_t msgAborted, 
boolean_t msgPaused, boolean_t msgResumed, 
boolean_t msgUnderrun, port_t reply Port) 

kem_retum_t snddriver_stream_start_reading(port_t streamPort, char * filename, 

int sampleCount, int regionTag, boolean_t msgStarted, 
boolean_t msgCompleted, boolean_t msgAborted, 
boolean_t msgPaused, boolean_t msgResumed, 
boolean_t msgOverrun, port_t replyPort) 
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Types and Constants 


Defined Types 


NXSoundDeviceError 

typedef enum _NXSoundDeviceError { 

NX_SoundDeviceErrorNone = 0, 

NX_SoundDeviceErrorKemel = NX_SOUNDDEVICE_ERROR_MIN, 
NX_SoundDeviceErrorTimeout, 

NX_SoundDeviceErrorLookUp, 

NX_SoundDeviceErrorHost, 

NX_SoundDeviceErrorNoDevice, 

NX_SoundDeviceErrorNotActive, 

NXjSoundDeviceErrorTag, 

NX_SoundDeviceErrorMax = NX_SOUNDDEVICE_ERROR_MAX 
} NXSoundDeviceError 

NXSoundStatus 

typedef enum { 

NX_SoundStopped, 

NX_SoundRecording, 

NX_SoundPlaying, 

NX_SoundInitialized, 

NX_SoundRecordingPaused, 

NX_SoundPlayingPaused, 

NX_SoundRecoraingFending, 

NX_SoundPlayingPending, 

NX_SoundFreed = -1, 

} NXSoundStatus; 

NXSoundStreamTime 

typedef struct timeval NXSoundStreamTime; 
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SNDCompressionSubheader 

typedef struct { 

int originalSize 
int method; 
int numDropped; 
int encodeLength; 

} SNDCompressionSubheader; 


SNDError 

typedef enum { 

SND_ERR_NONE, 

snd_err_not_sound, 

snd_err_bad_format, 

SND_ERR_BAD_RATE, 

snd_err_bad_channel, 

SND_ERR_BAD_SIZE, 

SND_ERR_BAD_FILENAME, 

SND_ERR_CANNOT_OPEN, 

SND_ERR_CANNOT_WRITE, 

SND_ERR_CANNOT_READ, 

snd_err_cannot_alloc, 

snd_err_cannot_free, 

SND_ERR_CANNOT_COPY, 

snd_err1cannot_reserve, 

SND_ERR_NOT_RESERVED, 

SND_ERR_CANNOT_RECORD, 

SND_ERR_ALREADY_RECORDING, 

snd_err_not_recording, 

SND_ERR_CANNOT_PLAY, 

SND_ERR_ALREADY_PLAYING, 

SND_ERR_NOT_IMPLEMENTED, 

SND_ERR_NOT_PLAYING, 

SND_ERR_CANNOT_FIND, 

SND_ERR_CANNOT_EDIT, 

snd_err_bad_space, 

SND_ERR_KERNEL, 

SND_ERR_BAD_CONFIGURATION, 

SND_ERR_CANNOT_CONFIGURE, 

SND_ERR_UNDERRUN, 

SND_ERR_ ABORTED, 
SND_ERR_BAD_TAG, 



SND_ERR_CANNOT_ACCESS, 

SND_ERR_TIMEOUT, 

SND_ERR_BUSY, 

SND_ERR_CANNOT_ABORT, 

SND_ERR_INFO_TOO_BIG, 

SND_ERR_UNKNOWN, 

} SNDError; 

SNDNotificationFun 

typedef int (*SNDNotificationFun) 
(SNDSoundStruct *s, 
int tag, 
int err)\ 

SNDSoundStruct 

typedef struct { 
int magic; 
int dataLocation; 
int dataSize; 
int dataFormat; 
int samplingRate; 
int channelCount; 
char info[4]; 

} SNDSoundStruct; 

snddriver_handlers 

typedef struct snddriver_handlers { 
void *arg; 
int timeout; 

sndreply_tagged_t started; 
sndreply_tagged_t completed; 
sndreply_tagged_t aborted; 
sndreply_tagged_t paused; 
sndreply_tagged_t resumed; 
sndreply_tagged_t overflow; 
sndreply_recorded_data_t recorded_data; 
sndreply_dsp_cond_true_t condition_true; 
sndreply_dsp_msg_t dsp_message; 
sndreply_dsp_msg_t dsp_error; 

} snddriver_handlers_t; 
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sndreply_dsp_cond_true_t 

typedef void (*sndreply_dsp_cond_true_t) 
(void *arg, 
unsigned int mask, 
unsigned int flags, 
unsigned int regs); 

sndreply_dsp_msg_t 

typedef void (*sndreply_dsp_msg_t) 

(void *arg, 
int data, 
int size); 

sndreply_recorded_data_t 

typedef void (*sndreply_recorded_data_t) 
(void *arg, 
int tag, 
void *data, 
int size); 

sndreply_tagged_t 

typedef void (*sndreply_tagged_t) 

(void *arg, 
int tag); 


Symbolic Constants 


ATC Frame Size 

ATC_FRAME_SIZE 


Compression Formats 

SND_CFORMAT_BITS_DROPPED 

snd_cformat_bit_faithful 

SND_CFORMAT_ATC 
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DSP Host Commands 


SNDDRIVER_DSP_HC_HOST_RD 
SNDDRIVER_DSP_HC_HOST_WD 
SNDDRIVER_DSP_HC_S YS_CALL 


DSP Protocol Options 

SNDDRIVER_DSP_PROTO_DSPERR 

SNDDRIVER_DSP_PROTO_C_DMA 

SNDDRIVER_DSP_PROTO_S_DMA 

SNDDRI VER_DS P_PROTO_HFAB ORT 

SNDDRIVER_DSP_PROTO_DSPMSG 

SNDDRIVER_DSP_PROTO_RAW 


Executable File Segment Name 

NX_S OUND_SEGMENT_NAME 


Null Notification Function 

SND_NULL_FUN 


Sound Devices 


Devices 


SND_ACCES S_IN Sound-in 

SND_ACCESS_DSP DSP 

SND_ACCESS_OUT Sound-out 


Sampling Rates 


Rates 


SND_R ATE_CODEC 

SND_RATE_LOW 

SND_RATE_HIGH 


8012.8210513 H 
22050.0 Hz 
44100.0 Hz 
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Sound Device Timeout Limit 

NX_SOUNDDEVICE_TIMEOUT_MAX 


Sound Device Error Code Limits 

NX_SOUNDDEVICE_ERROR_MIN 

NX_SOUNDDEVICE_ERROR_MAX 


Sound Stream Control Codes 

SNDDRIVER_AWAIT_STREAM 

SNDDRIVER_ABORT_STREAM 

SNDDRIVER_PAUSE_STREAM 

SNDDRIVER_RESUME_STREAM 


Sound Stream Null Time 

NXSOUNDSTREAM_TIME_NULL 


Sound Stream Path Codes 

SNDDRIVER_STREAM_FROM_SNDIN 

SNDDRIVER_STREAM_TO_SNDOUT_22 

SNDDRIVER_STREAM_TO_SNDOUT_44 

SNDDRIVER_STREAM_FROM_DSP 

SNDDRIVER_STREAM_TO_DSP 

SNDDRIVER_STREAM_DSP_TO_SNDOUT_22 

SNDDRIVER_STREAM_DSP_TO_SNDOUT_44 

SNDDRIVER_STREAM_THROUGH_DSP_TO_SNDOUT_22 

SNDDRI VER_STRE AM_THROUGH_D SP_TO_SNDOUT_44 

SNDDRIVER_DMA_STREAM_TO_DSP 

SNDDRIVER_DMA_STREAM_FROM_DSP 

SNDDRIVER_DMA_STREAM_THROUGH_DSP_TO_SNDOUT_22 

SNDDRIVER_DMA_STREAM_THROUGH_DSP_TO_SNDOUT_44 
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Sound Structure Formats 

SND_FORMAT_UNSPECIFIED 

SND_FORMAT_MULAW_8 

SND_FORMAT_LINEAR_8 

SND_FORMAT_LINEAR_ 16 

SND_FORMAT_LINEAR_24 

SND_FORMAT_LINEAR_32 

SND_FORMAT_FLOAT 

SND_FORMAT_DOUBLE 

SND_FORMAT_INDIRECT 

SND_FORMAT_DSP_CORE 

SND_FORMAT_DSP_DATA_8 

SND_FORMAT_DSP_DATA_l 6 

SND_FORM AT_DS P_DATA_24 

SND_FORMAT_DSP_DATA_32 

SND_FORMAT_DISPLAY 

SND_FORMAT_MULAW_SQUELCH 

SND_FORMAT_EMPHASIZED 

SND_FORMAT_COMPRES SED 

SND_FORMAT_COMPRESSED_EMPHASIZED 

SND_FORMAT_DSP_COMMANDS 


Sound Structure Magic Number 

SND_MAGIC 


SoundView Display Modes 

NX_S OUNDVIE W_MINM AX 
NX_SOUNDVIEW_WAVE 


Global Variables 


NXSoundPboardType 

extern NXAtom NXSoundPboardType; 
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3D Graphics Kit 


Classes 


N3DCamera 


Inherits From: View : Responder : Object 

Initializing and Freeing 

- init 

- initFrame:(const NXRect *)fRect 
-free 

All Drawing 

- (BOOL)lockFocus 

- unlockFocus 

- drawSelf:(NXRect *)rects :(int )nRects 


Initializes with 0 frame size 
Initializes with specified frame size 
Frees the N3DCamera 


YES if PostScript and RenderMan drawing lock on camera 
Unlocks PostScript and RenderMan drawing 
Performs all RIB and PostScript drawing 
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RenderMan Drawing 

- render 

- renderS elf: (RtToken)conto:/ 

- setFlushRIB:(BOOL]/fog 

- doesFlushRIB 

- flushRIB 

PostScript Drawing 

- drawPS:(NXRect *)rects :(int )nRects 

Background Color 

- setBackgroundColor:(NXColor)co/or 

- (NXColor)backgroundColor 

- setDrawBackgroundColor: (B OOL )flag 

- (BOOL)doesDrawBackgroundColor 

PostScript Transformation Management 

- setFrame:(const NXRect *)fRect 

- moveTo:(NXCoord)jc :(NXCoord)y 

- moveBy:(NXCoord )deltaX :(NXCoord)deltaY 

- sizeTo:(NXCoord)vv/Y///z :(NXCoord)he ight 

- sizeBy:(NXCoord)de ItaWidth 

: (NXCoord)deltaHeight 

- rotateTo:(NXCoord)ang/e 

- rotateBy:(NXCoord)d<?/ta4ng/e 

Shape Hierarchy Management 

- setWorldShaperaJDSVjape 

- worldShape 

Global Light Management 

-addLighUaLight 

- remoxeLight:aLight 

- lightList 


Renders the camera and any content shapes 
Override to perform custom rendering in the camera 
Sets the receiver to invoke flushRIB within render 
Tests whether the receiver invokes flushRIB within render 
Waits until all RIB code has been rendered 


Override to perform custom PostScript drawing 


Sets the NXColor filled behind all drawing 
The NXColor filled behind all drawing 
If flag is YES, fills color behind all drawing 
YES if camera fills color behind all drawing 


Sets frame for both PostScript and RenderMan coordinate 
systems 

Moves both PostScript and RenderMan coordinate systems 

Moves both PostScript and RenderMan coordinate systems 

Resizes both PostScript and RenderMan coordinate 
systems 

Resizes both PostScript and RenderMan coordinate 
systems 

Prevents rotation of PostScript coordinate system 

Prevents rotation of PostScript coordinate system 


Sets world shape 
Returns world shape 


Adds an N3DLight to the camera’s global light list 
Removes an N3DLight to the camera’s global light list 
Returns the camera’s global light list 
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Picking 

- selectShapesIn:(const NXRect *)selectionRect 

Projection Rectangle 

- setProjectionRectangle:(float)/<?/r 

: (float) n'g/tf 
: (float) top 
•.(float )bottom 

- getProjectionRectangle:(float *)left 

:(float *)right 
: (float *)top 
:(float *)bottom 

Selecting Projection Type 

- setProj ection: (N 3 DProj ec tionTy p e)aProjection 

- (N3DProjectionType)projectionType 

Pretransform Matrix 

- setPreTransformMatrix:(RtMatrix)t/ieMa/rk 

- getPreTransformMatrix:(RtMatrix)t/ieAtora: 
-setUsePreTransformMatrix:(BOOL)/fog 

- (BOOL)usesPreTransformMatrix 


Returns a List of N3DShapes in selectionRect 


Sets the 3D coordinate system projection rectangle 


Returns the 3D coordinate system’s projection 
rectangle 


Sets the projection type 
Returns the projection type 


Sets the camera’s pretransformation matrix 
Returns.the camera’s pretransformation matrix 
Sets the camera to use its pretransformation matrix 
YES if camera uses its pretransformation matrix 


Setting Viewpoint 

- setEyeAt:(RtPoint)/ramPomt 

toward :(RtPoint)toPomt 
roll:(float )aRollAngle 

- getEyeAt:(RtPoint *)fromPoint 

toward:(RtPoint *)toPoint 
roll:(float *)aRollAngle 

- moveEyeBy: (float) s Distance 

: (float )tDistance 
:(float )uDistance 

- rotateEyeBy:(float)d£7ev :(float)d4zim 

about: (RtPoint )pivotPtr 


Sets the eye-to-viewpoint vector and roll 


Gets the eye-to-viewpoint vector and roll 


Moves camera in its own coordinate system 


Rotates the camera in its own coordinates 
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Clipping Planes 

- setClipPlanesNear: (f\oaX)aNear Plane 

far: (float )aFarPlane 

- getClipPlanesNear:(float *)aNearPlane 

far: (float *)aFarPlane 

Field of View 

-setFieldOfViewByAngle:(float)v/evMftg/e 

-setFieldOfViewByFocalLength:(float)flLe«gt /2 

- (float)fieldOfView 

Pixel Aspect Ratio 

- setPixelAspectRatio:(float)r/zeifar/<9 

- (float)pixelAspectRatio 

Converting Coordinates 

- convertPoints:(RtPoint *)points 

count: (int )n 
fromSpace:aS7ztfpe 

- convertPoints:(NXPoint *)mcoords 

count:(int )pointCount 
toWorld:(RtPoint *)wcoords 

Crop Windows 

- (int)numCrop Windows 

- cropInRects:(NXRect *)theRects 

nRects:(int )rectConnt 

Frame Number 

- (int)frameNumber 


Sets the camera’s near and far clipping planes 
Returns the camera’s near and far clipping planes 


Sets the viewing angle of the camera 

Converts a focal length into a viewing angle for the camera 

Returns the viewing angle of the camera 


Sets the pixel aspect ratio for the camera 
Returns the pixel aspect ratio for the camera 


Converts an array of points to PostScript coordinates 

Converts PostScript points to world coordinates 


Count of rectangle divisions for photoreal rendering 

Returns rectangles representing horizontal strips of 
camera image 


Returns 1 


Printing 

- (BOOL)canPrintRIB Returns YES 
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Copying RIB 


- copyRIBCode:(NXStream *)stream Copies RIB code generated by the receiver 

Setting World Attributes 

- worldBegin:(RtToken)//ieCo/ 2 teJtr Calls RiWorldBegin() 

- worldEnd:(RtToken)t/ieCo/ite;tf Calls RiWorldEnd() 


Setting and Getting the Delegate 

- setDelegateicameraDelegate 

- delegate 

Setting the Hider 

- (N3DHider)hider 

- setHider:(N3DHider)cameraMder 

- setSurfaceTypeForAll:(N3DSurfaceType)52<//«ce 

chooseHider:(BOOL)//a£ 

Rendering Photorealistically 

- (int)renderAsEPS 

- (int)renderAsTIFF 

Archiving 

- read:(NXTypedStream *)theStream 

- write:(NXTypedStream *)theStream 

- awake 


Sets the receiver’s delegate 
Returns the receiver’s delegate 


Returns the receiver’s N3DHider 
Sets the receiver’s N3DHider 

Sets surface type for shapes in world shape hierarchy 


Begins rendering, returns identifier for rendering session 
Begins rendering, returns identifier for rendering session 


Reads the camera from the stream 

Writes the camera to the stream 

Performs additional initialization after unarchiving 


Methods Implemented by the Delegate 

- csanerauheCamera Handles images generated by photoreal rendering 

didRenderStream:(NXStream *)imageStream methods 
tag:(int )theJob 

frameNumber:(int)currentFrame 
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N3DContextManager 


Inherits From: Object 

Initializing and Freeing 

+ new 
-free 

Getting the Main Context 

- (RtToken)mainContext 

Creating Other Contexts 

- (RtToken)createContext:(const char *)name 

- (RtToken)createContext:(const char *)name 

withRenderer: (VXY6kcn)renderer 

- (RtToken)createContext: (const char *)came 

toFile:(const char *)ribFile 

- (RtToken)createContext: (const char *)name 

toStream:(NXStream *)stream 

Managing the Current Context 

- (RtToken)currentContext 

- (RtToken)setCu rren tContext: (RtTokenjconterf 

- (RtToken)setCurrentContextByName:(const char 


Returns (creating if necessary) one instance per application 
Destroys all contexts, frees the receiver 


Returns (creating if necessary) the application’s main 
context 


Creates a named context 

Creates a named context for a specific Tenderer 

Creates a named context on a file 

Does nothing, returns NULL 


The application’s current context 
Sets the current context, returns previous context 
*)name 

Sets the current context by name, returns previous context 


Destroying a Context 

- (void)destroy Context: (RtToken)contexr Destroys the context 

- (void)destroyContextByName:(const char *)name 

Destroys a context with name 


Archiving 

- awake 


Performs additional initialization after unarchiving 
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N3DLight 


Inherits From: N3DShape : Object 


Initializing 

-init 


Initializes the receiver as an N3D_AmbientLight 


Setting Light Type 

- setType:(N3DLightType)a7^pe 

- (N3DLightType)type 

-makeAmbientWithIntensity:(RtFloat)mten.s7Yy 

- makePointFrom:(RtPoint)/rom 

intensity: (RtFloat) intensify 

- makeDistantFrom: (RiPoint)fromPoint 

to: (RtPoint)toPomr 
intensity: (RtFloat)/ 

- makeSpotF rom: (RiPoint)fromPoint 

to: (RtPoint) toPomt 
coneAngle:(RtFloat)coneAng/e 
coneDelta: (RtFloat )deltaAngle 
beamDistribution:(RtFloat)d«rr/fcw//on 
intensity: (RtFloa ^intensity 

Setting Light Parameters 

- setFrom:(RtPoint)/ramPo/nt 

- setFrom:(RtPoint)/romPomt 

to: (RtPoint)toPomt 

- getFrom:(RtPoint *)fromPoint 

to:(RtPoint *)toPoint 

-setConeAngle:(RtFloat)coneAng/e 
coneDelta: (RtFloat)cwzeDe/ta 
beamDistribution: (RtFloat distribution 

- getConeAngle:(RtFloat *)coneAngle 

coneDelta:(RtFloat *)coneDelta 
beamDistribution:(RtFloat *) distribution 

- setIntensity:(RtFloat)mtensi'fy 

- (RtFloat)intensity 


Sets the receiver’s light type 
Returns the receiver’s light type 

Sets type N3D_AmbientLight with appropriate parameter 

Sets type N3D_PointLight with appropriate 
parameters 

Sets type N3D_PointLight with appropriate 
parameters 

Sets type N3D_SpotLight with appropriate parameters 


Sets the from point 
Sets the from and to points 

Returns the from and to points 

Sets the cone angle, cone delta, and beam distribution 

Gets the cone angle, cone delta, and beam distribution 

Sets the intensity 
Returns the intensity 
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Rendering 


- renderSeIf:(N3DCamera *)theCamera 

- renderGlobal:(N3DCamera *)theCamera 

Global Light Management 

- setGlobaI:(BOOL)/fag 

- (BOOL)isGIobal 

Switching On and Off 

- switchLight:(BOOL)/7tfg 

Setting Color 

- setColor:(NXColor)theColor 

- (NXColor)color 

Archiving 

- read:(NXTypedStream *)theStream 

- write:(NXTypedStream *)theStream 

- awake 


Renders the light as a local light 
Renders the light as a global light 


Override to add behavior on becoming/resigning global 
YES if light is global 


If flag is YES, turns receiver on 


Sets the receiver’s color 
Returns the receiver’s color 


Reads the receiver from the stream 

Writes the receiver to the stream 

Performs additional initialization after unarchiving 


N3DMovieCamera 

Inherits From: N3DCamera : View : Responder : Object 

Initializing 

- initFrame: (const NXRect *)fRect Initializes the receiver 

RenderMan Drawing 

- render Renders current frame; if printing, renders current page 
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Interactive Display 

- displayMovie 


Displays movie, first frame to last, onscreen 


Frame Numbers 

-setFrameNumber:(int)flFra/ne7VwmZ?er 

- (int)frameNumber 

- setStartFrame:(int).ytarr 

endFrame:(int)end 

incrementFramesBy:(int)sfc/p 

- (int)startFrame 

- (int)endFrame 

- (int)framelncrement 

Archiving 

- read:(NXTypedStream *)theStream 

- write: (NXTypedStream *)theStream 

- awake 


Sets the current frame number 
Returns the current frame number 
Sets counters for movie 

Returns the first frame number 
Returns the last frame number 
Returns the frame increment 


Reads the receiver from the stream 

Writes the receiver to the stream 

Performs additional initialization after unarchiving 


N3DRenderPanel 

Inherits From: Panel: Window : Responder: Object 

Initializing the Class 

+ initialize 
+ new 

Setting Accessory View 

- accessory View 

- setAccessoryViewjaV/evv 

Running Modal 

- (int)runModal Presents the render panel in a model loop 


Returns the accessory view 
Sets the accessory view 


Initializes the class with data from the defaults database 
Creates, if necessary, and returns an N3DRenderPanel 
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Resolution 


- (int)resolution Returns the resolution set by the user in the panel 

Host Management 

- (int)numSelectedHosts 

- (char **)hostNames 

Browser Delegate Method 

- (int)browser:5en<ier Fills the panel’s browser with host names 

GllMatrix:theMatrix 
inColumn:(int )col 


Returns the number of hosts selected by the user 
Returns an array of strings for selected host names 


N3DRIBImageRep 

Inherits From: NXImageRep : Object 

Initializing and Freeing 

- initFromFile:(const char *)ribfile 

- initFromStream:(NXStream *)ribStream 

-free 

Declaring Data Types 

+ (const char *const *)imageUnfilteredFileTypes Returns supported file types 

+ (const NXAtom *)imageUnfiIteredPasteboardTypes 

Returns supported pasteboard types 

+ (BOOL)canLoadFromStream:(NXStream *)theStream 

Tests theStream for RIB data 

Drawing 

drawn at point 
drawn in rect 
drawn 


- (BOOL)drawAt:(const NXPoint *)point 

- (BOOL)drawIn:(const NXRect *)rect 

- (BOOL)draw 


Returns YES if the image is successfully 
Returns YES if the image is successfully 
Returns YES if the image is successfully 


Initializes the receiver from a file 
Initializes the receiver from a stream 
Frees the receiver 
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Size 


- getBoundingBox:(NXRect *)rectangle 

- getSize:(NXSize *)theSize 

Background Color 

- (NXColor)backgroundColor 

- setBackgroundColor: (NXColor)theColor 

Hidden Surface Removal Type 

- (N3DHider)hider 

- setHider:(N3DHider)f/ie/frWer 

Surface Type 

- setSurfaceType:(N3DSurfaceType)type 

- (N3DSurfaceType)surfaceType 

Archiving 

- read:(NXTypedStream *)theStream 

- write:(NXTypedStream *)theStream 


Returns the rectangle that bounds the image 
Returns the size of the image 


Returns the background color 
Sets the background color 


Returns the hider type for rendering images 
Sets the hider type for rendering images 


Sets the surface type used for rendering images 
Returns the surface type used for rendering images 


Reads the receiver from the stream 
Writes the receiver to the stream 


IM3DRotator 


Inherits From: Object 

Initializing 

- init Initializes the receiver 

- initWithCameraimy Camera Initializes the receiver and sets its camera 

Setting Parameters 

- setCamera vnyCamera Sets the receiver’s camera 

- setCenter:(const NXPoint *)center Sets the receiver’s center point and radius 

andRadius: (float) ravins 
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Axes of Rotation 


- setRotation Axis: (N3 D Axis) axis 

- (N3DAxis)rotationAxis 

Mouse Tracking 

- trackMouseFrom:(const NXPoint *)lastPoint 

to: (const NXPoint *)thisPoint 
rotationMatrix:(RtMatrix)t/*e/tof< 2 ft' 0 n 
andlnverse: (RtMatrix)theInverse 

Archiving 

- read:(NXTypedStream *)theStrea?n 

- write : (NXTypedS tream *)theStream 


Sets the axes about which the receiver rotates 
Returns the axis about which the receiver rotates 


Accepts two points in camera coordinates, returns 
rotations based on their offset 


Reads the receiver from the stream 
Writes the receiver to the stream 


N3DShader 

Inherits From: Object 

Initializing and Freeing 

- init Initializes the receiver with no shader file 

- initWithShader: (const char *)aShader Initializes the receiver with a shader file 

- free Frees the receiver 


Shader Language Object File 

- setShader: (const char *)aShader 

- (const char *)shader 

Shader Color 

- setColor:(NXColor)aCo/or 

- (NXColor)color 

- setUseCo!or:(BOOL)/tag 

- (BOOL)doesUseColor 


Sets the receiver’s shader 
Returns the receiver’s shader 


Sets the receiver’s color 
Returns the receiver’s color 
Sets the receiver to apply its color 
YES if receiver applies color 
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Shader Transparency 

- setTransparency:(float)tf/p/:aVfr/H£ Sets the receiver’s transparency 

- (float)transparency Returns the receiver’s transparency 

Shader Function Argument Handling 

- (int)shaderArgCount The number of arguments for the shader function 

- (const char *)shaderArgNameAt:(int)arg/«£fec The name of the indicated argument 

- (SLO_TYPE)shaderArgType:(const char *)argName 


- (BOOL)isShaderArg:(const char *)argName 

- setShaderArg:(const char *)floatName 

floatValue: (float )floatValue 

- setShaderArg:(const char *)stringName 

stringVa!ue:(const char *)stringValue 

- setShaderArg: (const char *)pointName 

pointVahie:(RtPoint)pomrVfo/we 

- setShaderArg:(const char *)colorName 

coIorValue: (NXColor )colorValue 

- getShaderArg:(const char *)floatName 

floatValue:(float *)floatValue 

- getShaderArg: (const char *)stringName 

stringValue:(const char **)stringValue 

- getShaderArg:(const char *)pointName 

point Value: (RtPoint *)pointValue 

- getShaderArg:(const char *)colorName 

colorValue:(NXColor *)colorValue 

- resetShaderArg:(const char *)argName 

Shader Type 

- (SLO_TYPE)shaderType 

Setting 

-set 

Archiving 

- read:(NXTypedStream *)theStream 

- write:(NXTypedStream *)theStream 


The type of the named argument 

YES if argName is an argument to the shader function 

Sets the specified argument to the specified value 

Sets the specified argument to the specified value 

Sets the specified argument to the specified value 

Sets the specified argument to the specified value 

Gets the specified value for the specified argument 

Gets the specified value for the specified argument 

Gets the specified value for the specified argument 

Gets the specified value for the specified argument 

Resets the specified argument to its default value 

Returns the type of the shader 


Applies the shader function during rendering 


Reads the receiver from the stream 
Writes the receiver to the stream 
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N3DShape 


Inherits From: Object 

Initializing and Freeing 

-init 

-free 

- freeAll 

Rendering the N3DShape 

-render:(N3DCamera *)theCamera 

- renderSe!f:(N3DCamera *)theCamera 

- renderSelfAsBox:(N3DCamera *)theCamera 

Traversing the Shape Hierarchy 

- nextPeer 

- previousPeer 

- firstPeer 

- lastPeer 

- descendant 

- lastDescendant 

- ancestor 

- firstAncestor 

- (BOOL)isWorld 

Managing the Shape Hierarchy 

- linkPeenaPeer 

- linkDescendant: aDescendant 

- linkAncestor zanAncestor 

- unlink 

- group :anAncestor 

- ungroup 


Initializes and returns the receiver 

Frees the receiver and its descendants 

Frees the receiver, its next peer and its descendants 


Renders the shape and its descendants 
Override to implement actual rendering 
Renders only the shape’s bounding box 


Returns the shape “to the right” 

Returns the shape “to the left” 

Returns the shape “to the far left” of receiver’s peer group 

Returns the shape “to the far right” of receiver’s peer group 

Returns the shape “below” the receiver 

Returns the farthest descendant below the receiver 

Returns the shape “above the receiver 

Returns the shape at the top of the receiver’s hierarchy 

YES if the receiver is at the top of its hierarchy 


Inserts aPeer between receiver and its next peer 
Inserts aDescendant between receiver and its descendant 
Sets receiver’s ancestor, returns previous ancestor 
Unlinks the receiver, reconnects peers and descendants 
Makes the receiver a descendant of anAncestor 
Removes receiver from hierarchy, promotes descendant 
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Shader 


- setShader:aShader 

- shaderTtype:(SLO_TYPE)type 

Surface 

- (N3DSurfaceType)surfaceType 

- setSurfaceType:(N3DSurfaceType)t/z<?S , M//<2ce 

andDescendants: (BOOL)//a£ 

Bounding Box 

- getBoundingBox:(RtBound *)boundingBox 

- setDrawAsBox:(BOOL)//ag 

- (BOOL)doesDrawAsBox 

- getBounds:(NXRect *)boundingRect 

inCamera itheCamera 

Converting Points 

- convertObjectPoints:(RtPoint *)points 

count: (int)n 
toCamera '.camera 

- convertPoints:(RtPoint *)points 

count: (int)n 

fromAncestor: (N3 DShape *)theShape 

- convertPoints:(RtPoint *)points 

count:(int)n 

toAncestor:(N3DShape *)theShape 

Selectability 

- setSelectabIe:(BOOL)/fag 

- (BOOL)isSelectable 

Visibility 

- setVisible:(BOOL)/fog 

- (BOOL)is Visible 


Sets an N3DShader for the shape 
Returns the N3DShader of type 


Returns the receiver’s surface type 

Sets receiver’s surface type; if flag is YES, sets descendants 

surface types 


Returns by reference the receiver’s bounding box 
Sets the receiver to draw only its bounding box 
YES if the receiver draws only its bounding box 

Returns the rectangle representing the receiver’s 
bounding box in the coordinates of the camera 


Converts points from the receiver’s coordinate system 
to that of camera 

Converts points from an ancestor’s coordinate system 
to that of the receiver 

Converts points from the receiver’s coordinate system 
to that of an ancestor 


Sets whether the receiver can be selected 
YES if the receiver can be selected 


Sets the receiver to render when renderSelf: is invoked 
YES if receiver renders when renderSelf: is invoked 
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Naming Shapes 


- setShapeName:(const char *)aName 

- (const char *)shapeName 

Delegate for Rendering 

- setRenderDelegate:aS/wpe 

- removeRenderDelegate 

- renderDelegate 


Sets the name of the shape 
Returns the name of the shape 


Sets the rendering delegate for the receiver 
Removes and returns the render delegate 
Returns the render delegate 


Transformation Matrices 

-setTransformMatrix:(RtMatrix)newT’rans/orm 

Sets the receiver’s transformation matrix 

- getTransformMatrix:(RtMatrix)ta 2 tts/brm Returns the receiver’s transformation matrix 

- concatTransformMatrix:(RtMatrix)^eMfltm Multiplies the transform matrix with theMatrix, 

premuItiply:(BOOL)/7ag premultiplying by theMatrix if flag is YES 

-getCompositeTransformMatrix:(RtMatrix)t/ieM< 2 tra: 
relativeToAncestor:(N3DShape *)theAncestor 

Returns the matrix representing the transformation 
between theAncestoF s space and the receiver’s 

- getlnverseComposlteTransformMatrix: (R.tMatnx)theMatrix 

relativeToAncestor:(N3DShape *)theAncestor 

Returns the matrix representing the transformation 
between the receiver’s space and theAncestor' s 


Rotation, Scaling, Translation 

- rotateAngle:(float)ang 

axis: (RtPoint) referencePoint 

- preRotateAngle:(float)ang/e 

axis:(RtPoint )referencePoint 

- scale:(f\oa.t)xScaleFactor 

:(floa X)yScaleFactor 
: (float )zScaleFactor 

- prescale:(float )xScaleFactor 

:(f\oat)yScaleFactor 
: (float )zScaleFactor 

-scaleUniformly:(float)jca/eFactor 

-prescaleUniformly:(float)sca/eFactor 


Rotates the receiver about its origin and the point 

Premultiplies the rotation of the receiver about its 
origin and the point 
Scales the receiver 


Scales the receiver, premultiplying the transformation 


Scales the receiver uniformly in all axes 

Scales the receiver uniformly in all axes, premuliplying the 
transformation 
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- translate:(float )xTranslation Translates the receiver 

: (float )yTranslation 
:(float)zTranslation 

- pretranslate \(f[oal)xTranslation Translates the receiver, premultiplying the 

:({\o<it)yTranslation transformation 

: (ftoat)zTranslation 

Archiving 

- read:(NXTypedStream *)theStream Reads the camera from the stream 

- write:(NXTypedStream *)theStream Writes the camera to the stream 

- awake Performs additional initialization after unarchiving 
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Functions 


Data Component Functions 


Return components of 3D data structures: 

RtFloat N3D_XComp(RtFloat *theVector ) 

RtFloat N3D_YComp(RtFloat *theVector) 

RtFloat N3D_ZComp(RtFloat *theVector ) 

RtFloat N3D_WComp(RtFloat *theVector) 


Data Conversion Functions 


Convert between RtPoints and RtBounds: 

void N3D_ConvertBoundToPoints(RtBound theBound, RtPoint * thePoints ) 

void N3D_ConvertPointsToBound(RtPoint * thePoints, RtBound theBound) 


Data Copying Functions 


Efficiently copy 3D data types: 

void N3D_CopyBound(RtBound sourceBounds, RtBound destBounds) 

void N3D_CopyMatrix(RtMatrix sourceMatrix , RtMatrix desiNlatrix ) 

void N3D_CopyPoint(RtPoint sourcePoint, RtPoint destPoint) 


Intersection Testing Function 


Test for intersection between line and plane: 

void N3DIntersectLinePlane(RtPoint *endPoints, RtPoint planeNormal, 

RtPoint planePoint, RtPoint * intersection) 
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Matrix Manipulation Functions 


Efficient matrix multiplication: 

void N3DMultipIyMatrix(RtMatrix preTransform, RtMatrix postTransform, 

RtMatrix resultTransform ) 

float N3DInvertMatrix(RtMatrix theTransform, RtMatrix thelnverse) 


Transformation Functions 


Transform between coordinate systems: 

void N3DMuIt3DPoint(RtPoint thePoint, RtMatrix theTransform, RtPoint newPoint ) 

void N3DMult3DPoints(RtPoint *thePoints, int pointCount, 

RtMatrix theTransform, RtPoint *newPoints) 
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Types and Constants 


Defined Types 

N3DProjectionType 

typedef enum { 

N3D_Perspective, 
N3D_Orthographic 
} N3DProjectionType 


N3DLightType 

typedef enum { 

N3D_AmbientLight, 
N3D_PointLight, 
N3D_DistantLight, 
N3D_SpotLight 
} N3DLightType; 


N3DAxis 

typedef enum { 

N3D_AllAxes, 

N3D_XAxis, 

N3D_YAxis, 

N3D_ZAxis, 

N3D_XYAxes, 
N3D_XZAxes, 
N3D_YZAxes 
} N3DAxis; 

N3DHider 

typedef enum { 

N3D_HiddenRendering = 0, 
N3D_InOrderRendering, 
N3D_NoRendering 
} N3DHider 
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N3DShapeName 

typedef struct { 

char id [6]; 
char name; 
} N3DShapeName 


N3DSurfaceType 

typedef enum { 

N3D_PointCIoud = 0, 
N3D_WireF rame, 
N3D_ShadedWireFrame, 
N3D_FacetedSolids, 
N3D_SmoothSolids 
} N3DSurfaceType; 

SLOArgs 

typedef struct { 

SLO_VISSYMDEF symb; 
union { 

float fval; 

RtPoint pval; 
NXColor cval; 
char *sval; 

} value; 

} SLOArgs 


Symbolic Constants 


Matrix Constants 

N3D_BOTH_CLEAN 
N3D_CTM_DIRTY 
N3D_CTM_INVERSE_DIRTY 
N3D_CTM_B OTH_DIRTY 



Global Variables 


N3DldentityMatrix 

const RtMatrix N3DIdentityMatrix 


N3DOrigin 

const RtPoint N3DOrigin 


N3DRIBPboardType 

NXAtom N3DRIBPboardType 
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Video 


Classes 


NXLiveVideoView 

Inherits From: View : Responder : Object 

Initializing an NXLiveVideoView 

- initFrame:(const NXRect *)frameRect Initializes the receiver 

Freeing an NXLiveVideoView 

- free Frees the receiver 

Starting and Stopping Video Display 

- start '.sender 

- stop '.sender 

Determining the Active State 

- (BOOL)isVideoActive YES if the view is actively displaying video 


Starts video display in the video view 
Stops video display in the video view 


Classes: NXLiveVideoView 18-1 



Capturing Video as an NXImage 


- (NXImage *)grab Grabs and returns an image from video in the view 

- grabIn:(NXImage *)thelmage Grabs the image in the sourceRect and places it in 

fromRect:(NXRect *)sourceRect thelmage in destRect 

toRect:(NXRect *)destRect 

- (BOOL)doesGrabOnStop YES if the receiver grabs an image when, video stops 

- setGrabOnStop:(BOOL)/fog Sets the receiver to grab an image when video stops 


Finding the Video Resource 

+ (BOOL)doesRectSupportVideo: (const NXRectytheRect 

standard:(int *)theStandard YES if the specified rectangle can display video 

size:(NXSize *)theSize 

+ (BOOL)doesScreenSupportVideo:(const NXScreen *)theScreen 

standard:(int *)theStandard YES if the specified screen can display video 

size:(NXSize *)theSize 

+ (BOOL)doesWindowSupportYideo:r/ieWiWow 

standard:(int *)theStandard YES if the specified window can display video 

size:(NXSize *)theSize 

+ (const NXScreen *)videoScreen The screen best suited for video display 


Getting the Video Rectangle 

- getSourceVideoRect:(NXRect *)sourceRect 

Selecting the Video Input Port 

- sclectInjmt:(int)inputPortNumber 

- (int)numlnputs 

Setting the Output Mode: 

- setOutputMode:(int)outp«rMoJe 

Controlling Input Video Quality 

- setlnputBrightness: (float brightness 

- (float)inputBrightness 

- setInputGamma:(float )inputGamma 

- (float)inputGamma 

- setInputHue:(float)/zwe 

- (float)inputHue 


Returns the visible portion of the video view 


Sets the video input port 
Returns the number of video ports 


Sets the output mode of the video view 


Sets the input brightness value 
Returns the input brightness value 
Sets the input gamma value 
Returns the input gamma value 
Sets the input hue 
Returns the input hue 
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-setInputSaturation:(float)sfltaraf/ 0 n 

- (float)inputSaturation 

- setlnputSharpness : (float ) sharpness 

- (float)inputSharpness 

- resetPictureDefaults 

Controlling Output Video Quality 

- setOutputGamma:(/7e><2t) outputGamma 

- (float)outputGamma 

Getting the Video Standard 

- getVideoStandard:(int *) standard 

size:(NXSize *)vidRectSize 

Setting Output Genlock 

- setOutputGenlocked:(BOOL)/oc&ed 

- (BOOL)outputGenlocked 

Drawing 

- drawSelf:(const NXRect *)rects :(int )rectCount 

- drawVideoBackground:(const NXRect *)rects 

:(int)rectCount 

Setting a Delegate 

- delegate 

- setDelegate: anObject 

Archiving 

- read:(NXTypedStream *)stream 

- write :(NXTypedStream *)stream 

Delegate Method 

- videoDidActivatersender 

- videoDidSuspendtsender 


Sets the input saturation 

Returns the input saturation 

Sets the input sharpness 

Returns the input sharpness 

Restores all input video settings to their defaults 


Sets the output gamma 
Returns the output gamma 


Returns the video standard and size 


Locks video output to input signal 

YES if video output is genlocked to input signal 


Overridden to assure video updates correctly 
Invoked by drawSelf:: to assure correct video display 


Returns the receiver’s delegate 
Sets the receiver’s delegate 


Reads the receiver from the stream 
Writes the receiver to the stream 


Notifies the delegate when video activates 
Notifies the delegate when video stops 
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Types and Constants 


Symbolic Constants 


Input Selection 

NX_VIDEOIN 1 
NX_VIDEOIN2 
NX_VIDEOIN3 


Output Source 

NX_FROMINPUT 

NX_FROMVIEW 


Video Standard 

NX_NTSCSIGNAL 

NX_PALSIGNAL 
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1 B Workspace Manager 


Class 


WMInspector 

Inherits From: Object 

Accessing the Inspector Object 

+ new Creates a new WMInspector if none exists, or returns the 

existing one 

Accessing Panel Controls 

- okButton Returns the id of the Inspector’s OK button 

- revertButton Returns the id of the Inspector’s Revert button 

- window Returns the id of the window that contains the user 

interface for the inspector 

Accessing Workspace Selection 

- (unsigned)selectionCount Returns the number of items selected in the File Viewer 

- selectionPathsInto: (unsigned )pathString Returns the paths of the files selected in the File Viewer 

separator:(char)c/iarach?r 
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Managing Changes 

- okisender 

- rever tisender 

- textDidChange:.swj<fer 

- touch '.sender 


Implement in your subclass to commit the changes that the 
user has made to the selected item 

Implement in your subclass to load data into the inspector’s 
display 

Sends the WMInspector a touch: message 

Changes the image in the Inspector panel’s close box to a 
broken “X” 
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Mach Functions 


C-Thread Functions 

This section contains a summary of the C-thread functions, which are described in detail in the 
NeXTSTEP Operating System Software manual. 

To use the C-thread functions, include in your source files the header file mach/cthreads.h: 

#include <mach/cthreads.h> 


Basic C-Thread Functions 


Control a thread: 


cthread_t 

any_t 

void 

void 

kem_return_t 

void 


cthread_fork(any_t {^function )(), any_t arg) 
cthread join(cthread_t t) 
cthread_detach(cthread_t t) 
cthread_yield() 
cthread_abort(cthread_t t) 
cthread_exit(any_t result ) 


Get access to a thread: 

cthread_t cthread_self() 

thread_t cthread_thread(cthread_t t) 


C-Thread Functions 
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Associate a string with a thread: 


char * cthread_name(cthread_t t) 

void cthread_set_name(cthread_t t, char *name ) 

Associate data with a thread: 

any_t cthread_data(cthread_t t) 

void cthread_set_data(cthread_t t, any_t data) 

Change the priority of a thread: 

kem_retum_t cthread_max_priority(cthread_t t, processor_set_t processor_set, int 

max ^ priority) 

kem_retum_t cthread_priority(cthread_t t, int priority, boolean_t setjnax) 

Get or set the UNIX™ error number of this thread: 

int cthread_ermo() 

void cthread_set_ermo_se!f(int error) 

Get or set the maximum number of threads in this task: 

int cthread_limit() 

void cthread_set_limit(int limit) 

int cthread_count() 


Mutex Functions 

Control a mutex: 


mutex_t 

mutex_alloc() 

void 

mutex_init(struct mutex *m) 

void 

mutex_clear(struct mutex *m) 

void 

mutex_free(mutex_t m) 
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Associate a string with a mutex: 

char * mutex_name(mutex_t m) 

void mutex_set_name(mutex_t m, char *name ) 

Synchronize a mutex: 

void mutex_lock(mutex_t m) 

int mutex_try_lock(mutex_t m ) 

void mutex_unlock(mutex_t m) 


Condition Functions 


Control a condition variable: 


condition_t 

void 

void 

void 


condition_alloc() 
condition_init(struct condition *c) 
condition_clear(struct condition *c) 
condition_free(condition_t c) 


Associate a string with a condition variable: 

char * condition_name(condition_t c) 

void condition_set_name(condition_t c, char *name) 


Synchronize a condition variable: 

void condition_broadcast(condition_t c) 

void condition_signal(condition_t c ) 

void condition_wait(condition_t c, mutex_t m) 
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Mach Kernel Functions 


The Mach kernel is introduced in the Operating System Software manual. This section 
contains a summary of the Mach kernel functions, which are described in detail in Operating 
System Software. 

To use the Mach kernel functions, include in your source files the header file mach/mach.h: 

#include <mach/mach.h> 

To use the Mach message functions, also include in your source files the header file 
mach/message.h: 

#include cmach/mach.h> 

#include <mach/message.h> 

To use the Mach error string functions, include the header file mach/error.h, in addition to 

mach/mach.h: 

#include <mach/mach.h> 

#include <mach/error.h> 


Task Functions 


Control a task: 

kem_retum_t task_create(task_t parent Jask, boolean_t inheritjnemory, task_t *childjask) 

kem_retum_t task_suspend(task_t target jask ) 

kem_retum_t task_resume(task_t targetJask ) 

kem_retum_t task_terminate(task_t target Jask) 

Access a task or its threads: 

kem_retum_t task_threads(task_t target Jask, thread_array_t * threadJist, 

unsigned int * thread_count) 

kern_retum_t task_info(task_t target Jask, int flavor, task_info_t taskjnfo, 

unsigned int * taskjnfo _count) 
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Access a task's special ports: 


kern_retum_t 

kern_return_t 

port_t 

task_t 


task_get_special_port(task_t task, int which _port, port_t * special_port) 
task_set_special_port(task_t task, int which_port, port_t special_port ) 
task_notify() 
task_self() 


Translate between Mach task and UNIX process ID: 

kem_retum_t task_by_unix_pid(task_t task, int pid, task_t * result Jask ) 
kem_retum_t unix_pid(task_t target Jask, int *pid) 

Set a task's scheduling priority: 

kem_retum_t task_priority(task_t task, int priority, boolean_t change jthreads) 


Multiprocessor functions (not useful on single-processor systems): 


kem_return_t 

kem_retum_t 

kem_retum_t 


task_assign(task_t task, processor_set_t new_processor_set, 
boolean_t assignjthreads) 

task_assign_default(task_t task, boolean_t assignjthreads) 
task_get_assignment(task_t task, processor_set_t * processor_sei) 


Thread Functions 


Control a thread: 


kem_retum_t 

kem_return_t 

kern_retum_t 

kern_return_t 

kern_return_t 


thread_create(task_t parentjask, thread_t *childjhread) 
thread_suspend(thread_t targetjhread) 
thread_resume(thread_t target Jhread) 
thread_terminate(thread_t target Jhread) 
thread_abort(thread_t target jhread) 


Get information about a thread: 

kem_retum_t thread_info(thread_t target jhread, int flavor, thread_info_t threadJnfo, 

unsigned int * thread Jnfo_count) 
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Access a thread's state: 

kem_retum_t thread_get_state(thread_t target_thread, int flavor, thread_state_data_t old_state, 

unsigned int *old_state_count) 

kem_retum_t thread_set_state(thread_t target_thread, int flavor, thread_state_data_t new_state, 

unsigned int new_state_count) 


Access a thread's special ports: 


kem_retum_t 

kern_retum_t 

port_t 

thread_t 


thread_get_special_port(thread_t thread, int which_port, port_t * special_port ) 
thread_set_speciaI_port(thread_t thread, int which_port, port_t special_port) 
thread_reply() 
thread_self() 


Affect the scheduling policy or priority of a thread: 


kem_retum_t 

kem_retum_t 

kem_retum_t 

kem_retum_t 


thread_policy(thread_t thread, int policy, int data) 
thread_priority(thread_t thread, int priority, boolean_t setjnax) 
thread_max_priority(thread_t thread, processor_set_t processor_set, int priority ) 
thread_switch(thread_t new_thread, int option, int time) 


Multiprocessor functions (not useful on single-processor systems): 


kem_retum_t 

kcrn_return_t 

kern_return_t 


thread_assign(thread_t thread, processor_set_t newprocessor_set ) 
thread_assign_default(thread_t thread) 

thread_get_assignment(thread_t thread, processor_set_t * processor_set) 


Port Functions 


Control a port: 

kern_return_t 

kern_retum_t 

kern_retum_t 

kem_retum_t 


port_al!ocate(task_t task, port_name_t *port_name ) 
port_deallocate(task_t task, port_name_t portjxame) 
port_rename(task_t task, port_name_t oldjiame, port_name_t newjiame) 
port_set_back!og(task_t task, port_name_t port_name, int backlog ) 


Give a task rights to a port: 

kem_retum_t port_insert_receive(task_t task, port_t my_port, port_name_t itsjiame) 
kem_retum_t port_insert_send(task_t task, port_t my_port, port_name_t itsjiame ) 
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Remove a task's rights to a port: 


kem_retum_t port_extract_receive(task_t task, port_name_t its_name, port_t *its_port) 

kem_retum_t port_extract_send(task_t task, port_name_t its_name, port_t *its_port ) 

Get information about a port: 

kem_return_t port_status(task_t task, port_name_t portjiame, port_set_name_t 

*port_set_name, int *numjnsgs, int * backlog, boolean_t * owner, 
boolean_t * receiver ) 

kem_retum_t port_type(task_t task, port_name_t port_name, port_type_t *portjype) 

Get information about a task's port name space: 

kern_return_t port_names(task_t task, port_name_array_t *port_names, 

unsigned int *port_names_count, port_type_array_t *port_types, 
unsigned int *port_types_count) 


Control a port set: 

kem_return_t port_set_allocate(task_t task, port_set_name_t *set_name) 

kem_retum_t port_set_backup(task_t task, port_name_t portjiame, port_t backup, 

port_t * previous ) 

kem_retum_t port_set_deallocate(task_t task, port_set_name_t setjiame ) 

Access or modify a port set: 

kem_retum_t port_set_add(task_t task, port_set_name_t setjiame, port_name_t portjiame ) 
kem_retum_t port_set_remove(task_t task, port_name_t portjiame) 

kem_retum_t port_set_status(task_t task, port_set_name_t setjiame, 

port_name_array_t * members, unsigned int * membersjcount) 


Message Functions 


Send or receive a message: 


msg_return_t 

msg_return_t 

msg_return_t 


msg_send(msg_header_t * header, msg_option_t option, msg_timeout_t timeout) 
msg_receive(msg_header_t * header, msg_option_t option, msg_timeout_t timeout ) 
msg_rpc(msg_header_t * header, msg_option_t option, msg_size_t rcv_size, 
msg_timeout_t sendjimeout, msg_timeout_t rcvjimeout ) 
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Virtual Memory Functions 


Control virtual memory: 


kem_retum_t 

kem_return_t 

kem_retum_t 

kern_retum_t 


vm_allocate(vm_task_t target_task, vm_address_t * address, vm_size_t size, 
boolean_t anywhere) 

vm_dealIocate(vm_task_t targetjask, vm_address_t address, vm_size_t size ) 
vm_protect(vm_task_t targetjask, vm_address_t address, vm_size_t size, 
boolean_t setjnaximum, vm_prot_t newprotection ) 
vm_inherit(vm_task_t targetjask, vm_address_t address, vm_size_t size, 
vm_inherit_t newJnheritance) 


Access or modify the contents of virtual memory: 


kem_retum_t 

kern_return_t 

kem_retum_t 

kem_return_t 


vm_copy(vm_task_t targetjask, vm_address_t source_address, vm_size_t size, 
vm_address_t destjiddress) 

vm_read(vm_task_t targetjask, vm_address_t address, vm_size_t size, 
pointer_t *data, unsigned int *data_count) 
vm_write(vm_task_t targetjask, vm_address_t address, pointer_t data, 
unsigned int data_count ) 

map_fd(int fd, vm_offset_t offset, vm_offset_t * address, boolean_t findjpace, 
vm_size_t size ) 


Get information about virtual memory: 

kem_retum_t vm_region(vm_task_t targetjask, vm_address_t * address, vm_size_t *size, 

vm_prot_t * protection, vm_prot_t *maxprotection, 
vm_inherit_t * inheritance, boolean_t * shared, 
port_t *objectpame, vm_offset_t * offset) 

kem_retum_t vm_statistics(vm_task_t targetjask. vm_statistics_data_t *vm_stats) 


Host Functions 


Get this host's port: 

host_t host_self() 

host_priv_t host_priv_se!f() 
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Get information about a host: 


kem_retum_t host_info(host_t host, int flavor, host_info_t host_info, unsigned int 

*host_info_count) 

kem_return_t host_kernel_version(host_t host, kemel_version_t version) 

Get the name or privileged port of a processor set: 

kem_retum_t host_processor_set_priv(host_priv _t host_priv, 

processor_set_t processor_set_name, 
processor_set_t *processor_set ) 

kem_retum_t host_processor_sets(host_t host, processor_set_name_array_t *processor_set_list, 

unsigned int *processor_set_count) 

Get the ports of all processors on a host: 

kem_retum_t host_processors(host_priv_t host_priv, processor_array_t * processor_list, 

unsigned int ^processor_count) 


Processor Functions 


Get information about a processor: 

kem_retum_t processor_info(processor_t processor, int flavor, host_t *host, 

processor_info_t processor_info, 
unsigned int ^processor_info_counf) 

Get the name of the default processor set: 

kem_retum_t processor_set_default(host_t host, processor_set_t *default_set) 

Change the allowed scheduling policies of a processor set: 

kem_retum_t processor_set_policy_enable(processor_set_t processor_set, int policy ) 

kem_retum_t processor_set_po!icy_disabIe(processor_set_t processor_set, int policy, 

boolean_t change_threads ) 
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Get information about a processor set: 

kem_retum_t processor_set_info(processor_set_t processor_set, int flavor, host_t *host, 

processor_set_info_t processor_set_info, 
unsigned int * processor_set_info_count) 

kem_retum_t processor_set_tasks(processor_set_t processor_set, task_array_t *task_list, 

unsigned int *task_count ) 

kem_retum_t processor_set_threads(processor_set_t processor_set, thread_array_t *thread_list, 

unsigned int *thread_count ) 


Multiprocessor functions (not useful on single-processor systems}: 


kem_return_t 

kem_retum_t 

kem_retum_t 

kem_retum_t 

kem_retum_t 

kem_return_t 

kem_retum_t 

kem_retum_t 


processor_assign(processor_t processor, processor_set_t new_processor_set, 
boolean_t wait ) 

processor_controI(processor_t processor, processor_info_t info, long * count) 
processor_exit(processor_t processor) 
processor_get_assignment(processor_t processor, 
processor_set_t * processor_set) 
processor_start(processor_t processor) 

processor_set_create(host_t host, port_t *new_set, port_t *new_name) 
processor_set_destroy(processor_set_t processor_set) 

processor_set_max_priority(processor_set_t processor_set, int max _j uriority, 
boolean_t changeJhreads) 


Exception Functions 


Raise or handle exceptions: 


kem_retum_t 

void 
char * 
boolean_t 


exception_raise(port_t exception jport, port_t clear_port, port_t thread, port_t task, 
int exception, int code, int subcode) 

mach_NeXT_exception(char * string, int exception, int code, int subcode) 
mach_NeXT_exception_string(int exception, int code, int subcode) 
exc_server(msg_header_t *in, msg_header_t *out) 


Error String Functions 


Display or get a Mach error string: 

void mach_error(char * string, kem_retum_t ermo) 

char * mach_error_string(kern_return_t ermo) 


20-10 Chapter 20: Mach Functions 



Network Name Server Functions 


This section summarizes the Mach Network Name Server functions, which are not part of the 
Mach kernel. For more information see the Operating System Software manual. To use the 
Network Name Server functions, include in your source files the header files mach/mach.h and 
servers/netname.h: 

#include <mach/mach.h> 
ttinclude <servers/netname.h> 


Check a name into or out of the local name space: 

kern_return_t netname_check_in(port_t server_port, netname_name_t port_name, 

port_t signature, port_t portjd) 

kem_return_t netname_check_out(port_t serverjport, netname_name_t portjname, 

port_t signature ) 


Look up a name on a specific host: 

kem_retum_t netname_look_up(port_t server jport, netname_name_t hostjxame, 

netname_name_t portjiame, port_t *port_id) 
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Bootstrap Server Functions 


This section contains a summary of the Bootstrap Server functions, which are described in detail 
in the Operating System Software manual. 

To use a Bootstrap Server function, include in your source files the header files mach/mach.h and 
servers/bootstrap.h: 

#include <mach/mach.h> 

#include <servers/bootstrap.h> 

Look up a service: 

kem_retum_t bootstrap_look_up(port_t bootstrap_port, name_t service_name, 

port_t * service_port ) 

kern_retum_t bootstrap_look_up_array(port_t bootstrap_port, name_array_t service jiames, 

unsigned int service_names_count, port_array_t * servicejport, 
unsigned int * service_ports_count , 
boolean_t *all_services_knowri) 

Find out whether a service is active: 

kem_retum_t bootstrap_status(port_t bootstrap_port, name_t service_name, 

boolean_t * service _active ) 

Get information about all known services: 

kem_retum_t bootstrap_info(port_t bootstrap _port , name_array_t * service_nam.es, unsigned 

int * service jiames_count, name_array_t *server_names, 
unsigned int *server_names_count, bool_array_t * service _active, 
unsigned int *sen>ice_active_count) 


Check in a service: 

kem_retum_t bootstrap_check_in(port_t bootstrap_port, name_t service_name, 

port_all_t * service_port) 

kem_retum_t bootstrap_create_service(port_t bootstrapjport , name_t servicejiame, 

port_t * servicejport) 

kem_retum_t bootstrap_register(port_t bootstrap Jport , name_t servicejiame , port_t 

service _port ) 


Create a new bootstrap port: 

kem_retum_t bootstrap_subset(port_t bootstrap jport , port_t requestorjport , 

port_t * subsetjpori) 
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Kernel-Server Loader Functions 


This section contains a summary of the kernel-server loader functions, which are described in 
detail in the Operating System Software manual. Use these functions in a user-level program to 
communicate with the kernel-server loader, which controls all loadable kernel servers. 

To use these functions, include in your source files the header files mach/mach.h and 
kernserv/kern_loader_types.h. Most functions also require that you include the header file 
kernserv/kern_loader.h; the error functions require that you include the header file 
kernserv/kern_loader_error.h. Two other header files may be necessary: 
kernserv/kern_loader_reply_handler.h and kernserv/kern_loader_reply.h. 

To use these functions, you must compile with the kemload library. For example: 

cc myprog.c -lkernload 


Get a port to use in other kernel-server loader functions: 

kem_retum_t kern_loader_Look_up(port_t * loader_port ) 

kem_retum_t kern_loader_server_com_port(port_t loader_port, port_t task_port, 

server_name_t server_name, port_t * server_comjport ) 


Get or display an error string: 

void kern_loader_error(const char * string, kem_retum_t errno ) 

const char * kern_loader_error_string(kem_retum_t errno ) 

Affect the runnability of a loadable kernel server: 

kem_retum_t kern_loader_add_server(port_t loader jport , port_t taskjport , 

server_reloc_t serverjreloc ) 

kem_retum_t kern_loader_delete_server(port_t loader jport , port_t taskjport , 

server_name_t server jiame) 

kem_retum_t kern_loader_load_server(port_t loaderjport , server_name_t serverjiame) 

kem_retum_t kern_loader_unload_server(port_t loader jrort, port_t taskjport , 

server_name_t server jiame) 
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Get information from or about a loaded kernel server: 


kern_retum_t 

kern_retum_t 

kern_return_t 


kem_retum_t 


kern_loader_get_Iog(port_t loader_port, port_t serverj:om_port, port_t 
reply_port ) 

kern_loader_log_level(port_t loader_port, port_t server_com_port, int logjtevel) 
kem_loader_server_info(port_t loader jport, port_t taskjport, 

server_name_t serverjiame, server_state_t * server_state, 
vm_address_t *load_address, vm_size_t *load_size, 
server_reloc_t relocatable, server_reloc_t loadable, 
port_name_array_t *port_list, unsigned int *port_list_count, 
port_name_string_array_t *port_names, 
unsigned int *portjiames_count, boolean_array _t * advertised, 
unsigned int * advertisedjcount) 

kern_Ioader_server_task_port(port_t loader jport, port_t kerneljport, 
server_name_t server jiame, port_t * serverJaskjpori) 


Get general information from the kernel-server loader: 

kem_retum_t kern_loader_server_list(port_t loaderjport, server_name_array_t * serverjiames, 

unsigned int * serverjiames_count) 

kem_retum_t kern_loader_status_port(port_t loaderjtort, port_t listen jport) 


Request or handle an asynchronous message from the kernel-server loader: 

kem_retum_t kern_loader_ping(port_t loader jjort, port_t pingjjort, int id) 

kem_retum_t kern_loader_reply_handler(msg_header_t *msg, 

kem_loader_reply_t *kern_loaderjeply) 

Shut down or reconfigure the kernel-server loader: 

kem_retum_t kem_loader_abort(port_t loader jport, port_t privjport, boolean_t restart) 
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NeXTSTEP Programming 
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